Seedance

兼容接入

本页只列出 GlobalRouter 新增的豆包兼容路由。与直接调用火山方舟相比，请求体字段尽量保持一致； 接入时只需要把域名替换为 GlobalRouter 正式环境域名，把 API Key 替换为 GlobalRouter API Key， 并按接口类型使用对应的 /doubao 前缀路径。

Base URL
https://api.globalrouter.com

Authorization
Bearer <GlobalRouter API Key>

生成接口路径
/doubao/api/v3/...

素材接口路径
/doubao/?Action=<VolcAction>&Version=2024-01-01

生成接口

多模态向量、视频与图片生成接口保持火山方舟原生调用语义，GlobalRouter 路径在火山兼容路径前增加/doubao。

多模态向量化

OpenAI 兼容入口仅接受文本。图片、视频和混合输入使用以下豆包原生协议，字段与火山方舟保持一致。

curl https://api.globalrouter.com/doubao/api/v3/embeddings/multimodal \
  -H "Authorization: Bearer $GLOBALROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-embedding-vision-251215",
    "input": [
      { "type": "text", "text": "图片中的建筑是什么？" },
      { "type": "image_url", "image_url": { "url": "https://example.com/tower.png" } }
    ],
    "encoding_format": "float",
    "dimensions": 1024,
    "sparse_embedding": { "type": "disabled" }
  }'

素材接口

虚拟人像与真人人像素材接口统一使用火山 OpenAPI Action 风格。调用 GlobalRouter 时，域名替换为 GlobalRouter，路径固定为 /doubao/，Action、Version 与请求体字段按火山素材资产接口填写。 GlobalRouter 会完成 GR API Key 鉴权、方舟签名、资源归属记录和租户隔离。

SeedAudio 1.0 音频生成

请求体与火山引擎 SeedAudio 1.0 保持一致。将域名替换为 GlobalRouter，使用Authorization: Bearer <GlobalRouter API Key> 鉴权。GlobalRouter 服务端默认选择独立的doubao_audio Provider 及其上游凭据。

请求参数

响应字段

纯文本请求示例

curl -X POST "https://api.globalrouter.com/doubao/api/v3/tts/create" \
  -H "Authorization: Bearer $GLOBALROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-audio-1-0",
    "text_prompt": "生成一段舒缓的钢琴曲，氛围柔和、放松。",
    "audio_config": {
      "format": "mp3",
      "enable_subtitle": true
    }
  }'

音频参考请求示例

请将参考资源 URL 替换为上游能够访问的真实公网地址。

curl -X POST "https://api.globalrouter.com/doubao/api/v3/tts/create" \
  -H "Authorization: Bearer $GLOBALROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-audio-1-0",
    "text_prompt": "参考 @音频1 的风格，生成一段舒缓钢琴曲",
    "references": [{
      "audio_url": "https://example.com/reference.mp3"
    }],
    "audio_config": {
      "format": "mp3",
      "sample_rate": 48000,
      "speech_rate": 0,
      "loudness_rate": 0,
      "pitch_rate": 0,
      "enable_subtitle": true
    }
  }'

图片参考请求示例

curl -X POST "https://api.globalrouter.com/doubao/api/v3/tts/create" \
  -H "Authorization: Bearer $GLOBALROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seed-audio-1-0",
    "text_prompt": "根据图片氛围朗读：清晨，海边吹来温柔的风。",
    "references": [{
      "image_url": "https://example.com/reference.webp"
    }],
    "audio_config": {"format": "mp3"}
  }'

响应示例

{
  "code": 0,
  "message": "success",
  "audio": "<base64-audio>",
  "duration": 12.4,
  "original_duration": 12.4,
  "url": "https://example.com/generated.mp3",
  "subtitle": {
    "text": "清晨，海边吹来温柔的风。",
    "sentences": [{
      "start_time": 0,
      "end_time": 12400,
      "text": "清晨，海边吹来温柔的风。",
      "words": [{"start_time": 0, "end_time": 600, "text": "清晨"}]
    }]
  }
}

注意事项

官方参数和限制请以 火山引擎接口文档为准；价格与计费口径请参见 火山引擎计费说明。