API 使用指南

1. 基础绘图 — POST /draw

最基础的文生图/图生图接口，基于 Gemini 2.5 Flash 模型。

POST /api/v2/draw
{
  "messages": [
    {
      "role": "user",
      "content": [
        { "type": "text", "text": "一只可爱的小猫在花园里玩耍" }
      ]
    }
  ],
  "stream": false
}

想用参考图？在 content 数组里加一个 image_url 类型的元素就行。stream 设为 true 可以实时看到生成进度。

2. Pro 绘图 — POST /draw-pro

高级模型，画质更好，支持 2K/4K 分辨率。参数和基础绘图一样，多了个 size 参数。

POST /api/v2/draw-pro
{
  "messages": [...],  // 同上
  "stream": false,
  "size": "4K"        // 可选 2K 或 4K，默认 2K
}

3. 即梦 4.5 绘图 — POST /draw-4-5

即梦 4.5 模型，参数和 Pro 一样。

4. 一次出 4 张图 — POST /draw-4-5-four-images

一次请求生成 4 张图片，适合需要多个方案对比的场景。参数同基础绘图，不需要 stream。

5. 统一绘图接口 — POST /nano-pro 或 /images/gemini3pro

功能最全的绘图接口，支持多种模型、多通道、参考图（最多 14 张）、自定义比例。

POST /api/v2/nano-pro
{
  "prompt": "赛博朋克风格的城市夜景",
  "stream": false,
  "image_size": "2K",           // 可选 1K、2K、4K
  "aspect_ratio": "16:9",       // 可选 1:1、3:4、4:3、9:16、16:9
  "reference_images": [          // 可选，最多 14 张参考图
    "https://example.com/ref.jpg"
  ]
}

提交任务 — POST /video/generate

视频参数直接写在文本里，用 --ratio、--dur、--rs 控制。

// 文生视频
POST /api/v2/video/generate
{
  "model": "doubao-seedance-1.0-pro-fast",
  "content": [
    { "type": "text", "text": "小猫在花园玩耍 --ratio 16:9 --dur 5" }
  ]
}

// 图生视频：加一个 image_url 元素
// 首尾帧：加两个 image_url，分别设 role 为 first_frame 和 last_frame

查询结果 — GET /video/task

GET /api/v2/video/task?task_id=你的task_id

每 5~10 秒查一次，status 变成 completed 就能拿到 video_url 了。失败的话积分会自动退还。

生成视频 — POST /sora/generate

POST /api/v2/sora/generate
{
  "prompt": "一只猫咪在月光下漫步，电影质感",
  "aspect_ratio": "16:9",      // 16:9 或 9:16，默认 9:16
  "duration": 10,               // 10 或 15 秒
  "reference_image": "https://..." // 可选，参考图
}

Pro 版把路径换成 /sora/generate/pro，参数完全一样。

查询结果 — GET /sora/query

GET /api/v2/sora/query?task_id=你的task_id

角色定制

可以从已生成的视频中提取角色，然后在新视频中复用。

创建角色：POST /sora/create-character

查询角色：GET /sora/query-character?task_id=xxx

生成视频 — POST /veo/generate

POST /api/v2/veo/generate
{
  "model": "veo3-fast",         // 可选 veo3-fast、veo31、veo31-fast 等
  "prompt": "金毛犬在海边奔跑，夕阳西下",
  "aspectRatio": "16:9",        // 注意这里是驼峰命名
  "images": ["https://..."]     // 可选，0张=文生视频，1张=首帧，2张=首尾帧
}

查询结果 — GET /veo/task

GET /api/v2/veo/task?task_id=你的task_id

核心：生成音乐 — POST /music/generate

两种创作模式：灵感模式（给个描述让 AI 自由发挥）和自定义模式（自己写歌词）。

// 灵感模式：给个描述就行
POST /api/v2/music/generate
{
  "model": "chirp-v3-0",
  "title": "夏日微风",
  "make_instrumental": false,
  "gpt_description_prompt": "轻快的夏日流行曲，带有吉他和钢琴"
}

// 自定义模式：自己写歌词 + 风格标签
{
  "model": "chirp-v3-0",
  "title": "夏日微风",
  "make_instrumental": false,
  "prompt": "微风吹过田野\n阳光洒满大地",
  "tags": "pop, acoustic, summer"
}

// 延长模式：把一首歌续写下去
{
  "model": "chirp-v3-0",
  "title": "夏日微风（续）",
  "make_instrumental": false,
  "task": "extend",
  "continue_clip_id": "之前的歌曲ID"
}

// 翻唱模式
{
  "task": "cover",
  ...
}

查询结果

单个查询：GET /music/task?id=任务ID（注意这里是数字 ID）

批量查询：GET /music/tasks?ids=1,2,3

其他音乐接口

查余额 — GET /points/balance

GET /api/v2/points/balance
// 返回 { "remaining_points": 1500 }

查流水 — GET /points/logs

GET /api/v2/points/logs?page=1&pageSize=20
// type: 1=消耗 2=充值 3=手动调整 4=退还

查价格 — GET /gemini3pro/v2/channel-points

这个接口不需要认证，可以直接调用，返回所有 API 的积分价格。

完整调用流程（以 Sora 为例）

// 第一步：提交任务
const res = await fetch('/api/v2/sora/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer 你的access_key',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    prompt: '一只猫咪在月光下漫步',
    aspect_ratio: '16:9',
    duration: 10
  })
})
const { data } = await res.json()
const taskId = data.task_id  // 拿到任务 ID

// 第二步：轮询查结果
let result = null
for (let i = 0; i < 60; i++) {  // 最多查 60 次（5 分钟）
  await new Promise(r => setTimeout(r, 5000))  // 等 5 秒
  const query = await fetch(
    `/api/v2/sora/query?task_id=${taskId}`,
    { headers: { 'Authorization': 'Bearer 你的access_key' } }
  )
  const { data: task } = await query.json()

  if (task.status === 'completed') {
    result = task.video_url
    break
  }
  if (task.status === 'failed') {
    console.error('生成失败:', task.error)
    break
  }
}

console.log('视频地址:', result)