SeeAPI 开发文档

返回当前账户可调用的模型和输入能力 schema；示例为响应节选。

curl https://api.cgcm-api.com/v1/models \
  -H "Authorization: Bearer sk_live_xxx"

# 响应示例
{
  "object": "list",
  "data": [
    {
      "id": "seedance-2.0",
      "object": "model",
      "code": "seedance-2.0",
      "owned_by": "seeapi",
      "modality": "video",
      "execution_mode": "async",
      "input_schema": {
        "required": ["model", "prompt", "duration", "aspect_ratio", "resolution"],
        "properties": {
          "duration": { "enum": [-1, 4, 5, 6, "...", 15] },
          "resolution": { "enum": ["480p", "720p", "1080p", "4k"] },
          "aspect_ratio": { "enum": ["adaptive", "16:9", "4:3", "1:1", "3:4", "9:16", "21:9"] },
          "count": { "enum": [1, 2, 4], "default": 1 },
          "mode": { "enum": ["text2video", "singleImage2video", "frames2video", "image2video", "mixed2video"] },
          "generate_audio": { "type": "boolean", "default": true },
          "search_enabled": { "type": "boolean", "default": true },
          "reference_image_urls": { "type": "array", "maxItems": 9 },
          "reference_video_urls": { "type": "array", "maxItems": 3 },
          "reference_audio_urls": { "type": "array", "maxItems": 3, "description": "MP3 or WAV; requires an image or video reference" }
        }
      },
      "pricing_rule": { "currency": "credits" }
    },
    {
      "id": "seedance-2.0-fast",
      "object": "model",
      "code": "seedance-2.0-fast",
      "owned_by": "seeapi",
      "modality": "video",
      "execution_mode": "async",
      "input_schema": {
        "required": ["model", "prompt", "duration", "aspect_ratio", "resolution"],
        "properties": {
          "duration": { "enum": [-1, 4, 5, 6, "...", 15] },
          "resolution": { "enum": ["480p", "720p"] },
          "count": { "enum": [1, 2, 4], "default": 1 },
          "generate_audio": { "type": "boolean", "default": true },
          "search_enabled": { "type": "boolean", "default": true }
        }
      },
      "pricing_rule": { "currency": "credits" }
    },
    {
      "id": "happy-horse-1.1",
      "object": "model",
      "code": "happy-horse-1.1",
      "owned_by": "seeapi",
      "modality": "video",
      "execution_mode": "async",
      "input_schema": {
        "required": ["model", "prompt", "duration", "aspect_ratio", "resolution"],
        "properties": {
          "duration": { "enum": [3, 4, 5, "...", 15] },
          "resolution": { "enum": ["720p", "1080p"] },
          "aspect_ratio": { "enum": ["16:9", "9:16", "1:1", "4:3", "3:4"] },
          "count": { "enum": [1], "default": 1 },
          "mode": { "enum": ["text2video", "frames2video", "image2video"] },
          "reference_image_urls": { "type": "array", "maxItems": 9 }
        }
      },
      "pricing_rule": { "currency": "credits" }
    },
    {
      "id": "minimax-h3",
      "object": "model",
      "code": "minimax-h3",
      "owned_by": "seeapi",
      "modality": "video",
      "execution_mode": "async",
      "input_schema": {
        "required": ["model", "prompt", "duration", "aspect_ratio", "resolution"],
        "properties": {
          "duration": { "enum": [5,6,7,8,9,10,11,12,13,14,15] },
          "resolution": { "enum": ["768P","2K"] },
          "aspect_ratio": { "enum": ["adaptive","21:9","16:9","4:3","1:1","3:4","9:16"] },
          "count": { "enum": [1,2,4], "default": 1 },
          "mode": { "enum": ["text2video","singleImage2video","frames2video","mixed2video"] },
          "reference_image_urls": { "type": "array", "maxItems": 9 },
          "reference_video_urls": { "type": "array", "maxItems": 3 },
          "reference_audio_urls": { "type": "array", "maxItems": 3, "description": "MP3 or WAV; requires an image or video reference" }
        }
      },
      "pricing_rule": { "currency": "credits" }
    },
    {
      "id": "image-2-pro",
      "object": "model",
      "code": "image-2-pro",
      "owned_by": "seeapi",
      "modality": "image",
      "execution_mode": "sync",
      "input_schema": {
      "oneOf": [
            {
                  "type": "object",
                  "required": [
                        "model",
                        "prompt",
                        "size"
                  ],
                  "properties": {
                        "model": {
                              "const": "image-2-pro"
                        },
                        "prompt": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 4000
                        },
                        "n": {
                              "type": "integer",
                              "enum": [
                                    1
                              ],
                              "default": 1
                        },
                        "response_format": {
                              "type": "string",
                              "enum": [
                                    "b64_json",
                                    "url"
                              ],
                              "default": "b64_json"
                        },
                        "output_format": {
                              "type": "string",
                              "enum": [
                                    "jpeg",
                                    "png"
                              ],
                              "default": "jpeg"
                        },
                        "quality": {
                              "type": "string",
                              "enum": [
                                    "auto"
                              ],
                              "default": "auto"
                        },
                        "moderation": {
                              "type": "string",
                              "enum": [
                                    "auto"
                              ],
                              "default": "auto"
                        },
                        "size": {
                              "type": "string",
                              "enum": [
                                    "1024x1024",
                                    "1536x864",
                                    "1360x1024",
                                    "1536x1024",
                                    "864x1536",
                                    "1024x1360",
                                    "1024x1536",
                                    "2048x2048",
                                    "3072x1728",
                                    "2720x2048",
                                    "3072x2048",
                                    "1728x3072",
                                    "2048x2720",
                                    "2048x3072",
                                    "3840x2160",
                                    "3264x2448",
                                    "3520x2336",
                                    "2160x3840",
                                    "2448x3264",
                                    "2336x3520"
                              ]
                        }
                  },
                  "additionalProperties": false
            },
            {
                  "type": "object",
                  "required": [
                        "model",
                        "prompt",
                        "size",
                        "input_reference"
                  ],
                  "properties": {
                        "model": {
                              "const": "image-2-pro"
                        },
                        "prompt": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 4000
                        },
                        "n": {
                              "type": "integer",
                              "enum": [
                                    1
                              ],
                              "default": 1
                        },
                        "response_format": {
                              "type": "string",
                              "enum": [
                                    "b64_json",
                                    "url"
                              ],
                              "default": "b64_json"
                        },
                        "output_format": {
                              "type": "string",
                              "enum": [
                                    "jpeg",
                                    "png"
                              ],
                              "default": "jpeg"
                        },
                        "quality": {
                              "type": "string",
                              "enum": [
                                    "auto"
                              ],
                              "default": "auto"
                        },
                        "moderation": {
                              "type": "string",
                              "enum": [
                                    "auto"
                              ],
                              "default": "auto"
                        },
                        "size": {
                              "type": "string",
                              "enum": [
                                    "1024x1024",
                                    "1536x864",
                                    "1360x1024",
                                    "1536x1024",
                                    "864x1536",
                                    "1024x1360",
                                    "1024x1536",
                                    "2048x2048",
                                    "3072x1728",
                                    "2720x2048",
                                    "3072x2048",
                                    "1728x3072",
                                    "2048x2720",
                                    "2048x3072",
                                    "3840x2160",
                                    "3264x2448",
                                    "3520x2336",
                                    "2160x3840",
                                    "2448x3264",
                                    "2336x3520"
                              ]
                        },
                        "input_reference": {
                              "anyOf": [
                                    {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 29360128,
                                          "pattern": "^data:image\\/(png|jpeg|jpg|webp);base64,[A-Za-z0-9+/]+={0,2}$"
                                    },
                                    {
                                          "type": "string",
                                          "minLength": 1,
                                          "maxLength": 4096,
                                          "format": "uri",
                                          "pattern": "^https:\\/\\/.+"
                                    }
                              ]
                        }
                  },
                  "additionalProperties": false
            },
            {
                  "type": "object",
                  "required": [
                        "model",
                        "prompt",
                        "size",
                        "input_references"
                  ],
                  "properties": {
                        "model": {
                              "const": "image-2-pro"
                        },
                        "prompt": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 4000
                        },
                        "n": {
                              "type": "integer",
                              "enum": [
                                    1
                              ],
                              "default": 1
                        },
                        "response_format": {
                              "type": "string",
                              "enum": [
                                    "b64_json",
                                    "url"
                              ],
                              "default": "b64_json"
                        },
                        "output_format": {
                              "type": "string",
                              "enum": [
                                    "jpeg",
                                    "png"
                              ],
                              "default": "jpeg"
                        },
                        "quality": {
                              "type": "string",
                              "enum": [
                                    "auto"
                              ],
                              "default": "auto"
                        },
                        "moderation": {
                              "type": "string",
                              "enum": [
                                    "auto"
                              ],
                              "default": "auto"
                        },
                        "size": {
                              "type": "string",
                              "enum": [
                                    "1024x1024",
                                    "1536x864",
                                    "1360x1024",
                                    "1536x1024",
                                    "864x1536",
                                    "1024x1360",
                                    "1024x1536",
                                    "2048x2048",
                                    "3072x1728",
                                    "2720x2048",
                                    "3072x2048",
                                    "1728x3072",
                                    "2048x2720",
                                    "2048x3072",
                                    "3840x2160",
                                    "3264x2448",
                                    "3520x2336",
                                    "2160x3840",
                                    "2448x3264",
                                    "2336x3520"
                              ]
                        },
                        "input_references": {
                              "oneOf": [
                                    {
                                          "type": "array",
                                          "minItems": 1,
                                          "maxItems": 6,
                                          "items": {
                                                "type": "string",
                                                "minLength": 1,
                                                "maxLength": 29360128,
                                                "pattern": "^data:image\\/(png|jpeg|jpg|webp);base64,[A-Za-z0-9+/]+={0,2}$"
                                          }
                                    },
                                    {
                                          "type": "array",
                                          "minItems": 1,
                                          "maxItems": 6,
                                          "items": {
                                                "type": "string",
                                                "minLength": 1,
                                                "maxLength": 4096,
                                                "format": "uri",
                                                "pattern": "^https:\\/\\/.+"
                                          }
                                    }
                              ]
                        }
                  },
                  "additionalProperties": false
            }
      ]
},
      "pricing_rule": { "currency": "credits" }
    },
    {
      "id": "seedream-5.0-pro",
      "object": "model",
      "code": "seedream-5.0-pro",
      "owned_by": "seeapi",
      "modality": "image",
      "execution_mode": "async",
      "input_schema": {
        "required": ["model", "prompt"],
        "properties": {
          "size": { "type": "string", "pattern": "^(?:1K|2K|4K|[1-9][0-9]{0,4}x[1-9][0-9]{0,4})$", "default": "2K" },
          "n": { "enum": [1], "default": 1 },
          "response_format": { "enum": ["url"], "default": "url" },
          "output_format": { "enum": ["png"], "default": "png" },
          "watermark": { "type": "boolean", "default": false },
          "input_reference": { "type": "string", "description": "one active asset://ref_... image" },
          "input_references": { "type": "array", "minItems": 1, "maxItems": 6, "description": "active asset://ref_... images" }
        }
      },
      "pricing_rule": { "currency": "credits" }
    },
    {
      "id": "grok-imagine-video-1.5-preview",
      "object": "model",
      "code": "grok-imagine-video-1.5-preview",
      "owned_by": "seeapi",
      "modality": "video",
      "execution_mode": "async",
      "input_schema": {
        "required": ["model", "prompt", "input_reference", "seconds", "size"],
        "properties": {
          "input_reference": { "description": "single base64 image data URL or HTTPS image URL" },
          "seconds": { "enum": [1, 2, 3, "...", 15] },
          "size": { "enum": ["1280x720", "720x1280"] }
        }
      },
      "pricing_rule": { "currency": "credits" }
    },
    {
      "id": "grok-imagine-video-1.5-preview-pro",
      "object": "model",
      "code": "grok-imagine-video-1.5-preview-pro",
      "owned_by": "seeapi",
      "modality": "video",
      "execution_mode": "async",
      "input_schema": {
        "required": ["model", "prompt", "seconds", "size"],
        "properties": {
          "input_reference": { "description": "single base64 image data URL or HTTPS image URL" },
          "input_references": { "description": "1 to 7 base64 image data URLs or HTTPS image URLs", "minItems": 1, "maxItems": 7 },
          "seconds": { "enum": [1, 2, 3, "...", 15] },
          "size": { "enum": ["1280x720", "720x1280"] }
        },
        "oneOf": [
          { "required": ["input_reference"] },
          { "required": ["input_references"] }
        ]
      },
      "pricing_rule": { "currency": "credits" }
    },
    {
      "id": "gpt-5.5",
      "object": "model",
      "code": "gpt-5.5",
      "owned_by": "seeapi",
      "modality": "text",
      "execution_mode": "sync",
      "input_modalities": ["text", "image"],
      "input_schema": {
        "required": ["model", "messages"],
        "properties": {
          "messages": { "type": "array", "description": "text and image content parts only" },
          "max_completion_tokens": { "type": "integer" },
          "stream": { "type": "boolean" }
        }
      },
      "pricing_rule": { "currency": "credits" }
    }
  ]
}

返回账户余额、币种和因余额不足暂停的 API Key 数量。

curl https://api.cgcm-api.com/v1/credits \
  -H "Authorization: Bearer sk_live_xxx"

# 响应示例
{
  "balance_units": 12000000,
  "currency": "credits",
  "price_tier": "retail",
  "paused_api_keys": 0
}

创建异步视频生成任务。成功时返回 202 Accepted 和任务 ID。

curl https://api.cgcm-api.com/v1/video/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-20260510-0001" \
  -d '{
  "model": "seedance-2.0",
  "prompt": "基于产品参考图生成一段自然柔光下的展示视频。",
  "reference_image_urls": [
    "https://media.example.com/reference/product.jpg"
  ],
  "reference_video_urls": [
    "https://media.example.com/reference/action.mp4"
  ],
  "reference_audio_urls": [
    "https://media.example.com/reference/music.mp3"
  ],
  "duration": 5,
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "count": 1,
  "generate_audio": true,
  "search_enabled": true,
  "callback_url": "https://client.example.com/webhooks/seeapi"
}'

用整数 -1 让模型选择输出时长。

curl https://api.cgcm-api.com/v1/video/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: smart-duration-business-task-0001" \
  -d '{
  "model": "seedance-2.0-fast",
  "prompt": "产品在自然柔光下缓慢旋转展示，镜头平稳推进。",
  "duration": -1,
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "mode": "text2video",
  "count": 1
}'

示例展示 Seedance 2.0 的首尾帧顺序。

curl https://api.cgcm-api.com/v1/video/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedance-frames-order-20260807-0001" \
  -d '{
  "model": "seedance-2.0-mini",
  "prompt": "从首帧自然运动到尾帧，保持人物、服装和场景连续。",
  "reference_image_urls": [
    "https://media.example.com/reference/first.jpg",
    "https://media.example.com/reference/last.jpg"
  ],
  "duration": 4,
  "aspect_ratio": "9:16",
  "resolution": "480p",
  "count": 1,
  "mode": "frames2video",
  "generate_audio": false
}'

示例组合图片、视频和音频。

curl https://api.cgcm-api.com/v1/video/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedance-mixed-order-20260807-0001" \
  -d '{
  "model": "seedance-2.0-mini",
  "prompt": "综合图片主体、视频动作和音频节奏生成连续镜头。",
  "reference_image_urls": [
    "https://media.example.com/reference/product.jpg"
  ],
  "reference_video_urls": [
    "https://media.example.com/reference/action.mp4"
  ],
  "reference_audio_urls": [
    "https://media.example.com/reference/music.mp3"
  ],
  "duration": 4,
  "aspect_ratio": "9:16",
  "resolution": "480p",
  "count": 1,
  "mode": "mixed2video",
  "generate_audio": true
}'

显式指定 frames2video，按首帧、尾帧顺序填写两张图片。

curl https://api.cgcm-api.com/v1/video/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedance-25-frames-order-20261007-0001" \
  -d '{
  "model": "seedance-2.5",
  "prompt": "从首帧自然运动到尾帧，保持主体与场景连续。",
  "reference_image_urls": [
    "https://media.example.com/reference/first.jpg",
    "https://media.example.com/reference/last.jpg"
  ],
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "count": 1,
  "mode": "frames2video",
  "generate_audio": false
}'

不传参考素材；mode 可省略，也可以明确指定 text2video。

curl https://api.cgcm-api.com/v1/video/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedance-25-text-order-20260814-0001" \
  -d '{
  "model": "seedance-2.5",
  "prompt": "生成一段自然光下的城市街景镜头，运镜平稳，画面连续。",
  "duration": 12,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "count": 1,
  "mode": "text2video",
  "generate_audio": true,
  "search_enabled": true
}'

显式选择 mixed2video，并组合三种参考素材。

curl https://api.cgcm-api.com/v1/video/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedance-25-mixed-order-20260814-0001" \
  -d '{
  "model": "seedance-2.5",
  "prompt": "综合参考素材中的主体、动作和音乐节奏，生成风格统一的连续镜头。",
  "reference_image_urls": [
    "https://media.example.com/reference/product.jpg"
  ],
  "reference_video_urls": [
    "https://media.example.com/reference/action.mp4"
  ],
  "reference_audio_urls": [
    "https://media.example.com/reference/music.mp3"
  ],
  "duration": 12,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "count": 1,
  "mode": "mixed2video",
  "generate_audio": true,
  "search_enabled": true
}'

仅填写音频直链，其他参考字段省略。

curl https://api.cgcm-api.com/v1/video/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedance-audio-business-task-0001" \
  -d '{
  "model": "seedance-2.5",
  "prompt": "根据音频的音乐节奏生成连续画面，动作与节奏自然同步。",
  "reference_audio_urls": [
    "https://media.example.com/reference/music.mp3"
  ],
  "duration": 12,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "count": 1,
  "generate_audio": true
}'

恰好一段视频，可附加图片，不传音频。duration=0、aspect_ratio=adaptive 时，省略 mode 会自动选择 videoEdit2video；输出时长和画幅由输入视频决定。示例展示显式模式。

curl https://api.cgcm-api.com/v1/video/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedance-25-edit-order-20260814-0001" \
  -d '{
  "model": "seedance-2.5",
  "prompt": "保持原视频主体和动作连续性，按参考图片调整整体视觉风格。",
  "reference_video_urls": [
    "https://media.example.com/reference/source.mp4"
  ],
  "reference_image_urls": [
    "https://media.example.com/reference/style.jpg"
  ],
  "duration": 0,
  "aspect_ratio": "adaptive",
  "resolution": "720p",
  "count": 1,
  "mode": "videoEdit2video",
  "generate_audio": true,
  "search_enabled": true
}'

Prime 的最小文生视频请求。

curl https://api.cgcm-api.com/v1/video/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: wan30-prime-order-20260827-0001" \
  -d '{
  "model": "wan3.0-video-prime",
  "prompt": "生成一段具有电影感的城市夜景推进镜头，运动自然、画面稳定。",
  "duration": 2,
  "aspect_ratio": "16:9",
  "resolution": "480P",
  "count": 1,
  "mode": "text2video",
  "generate_audio": false
}'

使用本账号的有效视频素材引用。

curl https://api.cgcm-api.com/v1/video/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: wan30-video-reference-order-20260827-0001" \
  -d '{
  "model": "wan3.0-video",
  "prompt": "参考已有视频的镜头运动和节奏，生成一段新的城市夜景镜头。",
  "reference_video_urls": [
    "asset://ref_video_xxx"
  ],
  "duration": 2,
  "aspect_ratio": "16:9",
  "resolution": "480P",
  "count": 1,
  "mode": "mixed2video",
  "generate_audio": false
}'

用提示词创建一条 5 秒的 720p 视频。

curl https://api.cgcm-api.com/v1/videos \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: kling4-text-0001" \
  -d '{
  "model": "kling-4.0",
  "prompt": "清晨的海边，镜头平稳推进，海浪轻拍礁石。",
  "mode": "text2video",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "count": 1
}'

组合一张参考图和一段参考视频。不需要参考图时可省略 reference_image_urls。

curl https://api.cgcm-api.com/v1/videos \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: kling4-reference-0001" \
  -d '{
  "model": "kling-4.0",
  "prompt": "参考视频中的镜头运动和节奏，生成一段雨后城市街景。",
  "mode": "mixed2video",
  "duration": 5,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "count": 1,
  "reference_image_urls": [
    "asset://ref_image_xxx"
  ],
  "reference_video_urls": [
    "asset://ref_video_xxx"
  ]
}'

完整示例同时使用图片、视频和音频参考；不需要的素材字段可以删除，但 mode 必须与实际素材组合一致。

curl https://api.cgcm-api.com/v1/video/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: minimax-h3-order-20260804-0001" \
  -d '{
  "model": "minimax-h3",
  "prompt": "保持人物、服装和场景一致，生成自然连续的电影感动作。",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "768P",
  "count": 1,
  "mode": "mixed2video",
  "reference_image_urls": [
    "asset://ref_image_xxx"
  ],
  "reference_video_urls": [
    "asset://ref_video_xxx"
  ],
  "reference_audio_urls": [
    "asset://ref_audio_xxx"
  ],
  "callback_url": "https://client.example.com/webhooks/seeapi"
}'

preview 要求单张图片参考；preview-pro 要求 1–7 张图片参考，不支持纯文生视频。两者都支持横竖 720P 和 1–15 秒任意整数。

curl https://api.cgcm-api.com/v1/videos \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: video-order-20260703-0001" \
  -d '{
  "model": "grok-imagine-video-1.5-preview",
  "prompt": "让参考图中的画面产生轻微电影感推进，保持自然、简洁。",
  "input_reference": "https://client.example.com/reference.png",
  "seconds": 4,
  "size": "1280x720"
}'

创建同步图片生成任务。成功响应会返回 base64 图片内容，客户侧可保存为图片文件。

curl https://api.cgcm-api.com/v1/images/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: image-order-20260703-0001" \
  -d '{
  "model": "image-2-pro",
  "prompt": "一张干净的产品主图，白色背景，柔和自然光。",
  "size": "1024x1024",
  "n": 1,
  "response_format": "b64_json"
}'

必须提供 Idempotency-Key。省略参考字段为文生图；单图或多图参考只能使用上传后属于当前账号的 asset://ref_...。默认且仅支持 response_format=url。

curl https://api.cgcm-api.com/v1/images/generations/async \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: image-async-20260906-0001" \
  -d '{
  "model": "image-2-pro",
  "prompt": "一张白色背景的产品图片",
  "size": "1024x1024"
}'

提交 1 到 6 张图片参考和提示词，生成保持参考图主体、构图或风格的新图片。参考图建议使用公网 HTTPS 图片 URL。

curl https://api.cgcm-api.com/v1/images/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: image-order-20260703-0002" \
  -d '{
  "model": "image-2-pro",
  "prompt": "综合参考图主体和风格，调整为高端商业摄影质感。",
  "size": "2160x3840",
  "input_references": [
    "https://client.example.com/reference-1.png",
    "https://client.example.com/reference-2.jpg"
  ],
  "n": 1,
  "response_format": "b64_json"
}'

示例用 size=2560x1440 严格指定 16:9，并使用一张已上传且激活的普通参考图；纯文生图时删除 input_references 字段。

curl https://api.cgcm-api.com/v1/images/generations/async \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedream-5-pro-order-20260822-0001" \
  -d '{
  "model": "seedream-5.0-pro",
  "prompt": "保留参考图主体与构图，只修改标注区域内的商品颜色。",
  "size": "2560x1440",
  "n": 1,
  "response_format": "url",
  "output_format": "png",
  "watermark": false,
  "input_references": [
    "asset://ref_image_xxx"
  ]
}'

Nano Banana 使用 image_size 和 aspect_ratio 选择输出规格。当前支持 Flash 和 Pro 两档。

curl https://api.cgcm-api.com/v1/images/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nano-banana-order-20260708-0001" \
  -d '{
  "model": "nano-banana-flash",
  "prompt": "一张高质感产品海报，柔和灯光，干净背景。",
  "image_size": "2K",
  "aspect_ratio": "9:16",
  "n": 1,
  "response_format": "b64_json"
}'

提交 1 到 6 张图片参考。

curl https://api.cgcm-api.com/v1/images/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: nano-banana-order-20260708-0002" \
  -d '{
  "model": "nano-banana-pro",
  "prompt": "保持参考图产品外观一致，生成高端电商详情页场景图。",
  "image_size": "4K",
  "aspect_ratio": "3:4",
  "input_references": [
    "https://client.example.com/product-reference.png"
  ],
  "n": 1,
  "response_format": "b64_json"
}'

上传图片文件并读取返回的素材引用。

curl https://api.cgcm-api.com/v1/assets/references/upload \
  -H "Authorization: Bearer sk_live_xxx" \
  -F "kind=image" \
  -F "file=@./product-reference.png"

# 成功响应示例
{
  "id": "ref_xxx",
  "object": "reference.asset",
  "kind": "image",
  "asset_uri": "asset://ref_xxx",
  "status": "active",
  "mime_type": "image/png",
  "size_bytes": 123456,
  "created_at": "2026-06-26T08:00:00.000Z"
}

分别上传 MP4/MOV 视频或 MP3/WAV 音频。

curl https://api.cgcm-api.com/v1/assets/references/upload \
  -H "Authorization: Bearer sk_live_xxx" \
  -F "kind=video" \
  -F "file=@./motion-reference.mp4"

curl https://api.cgcm-api.com/v1/assets/references/upload \
  -H "Authorization: Bearer sk_live_xxx" \
  -F "kind=audio" \
  -F "file=@./audio-reference.mp3"

# 视频成功响应示例
{
  "id": "ref_video_xxx",
  "object": "reference.asset",
  "kind": "video",
  "asset_uri": "asset://ref_video_xxx",
  "status": "active",
  "mime_type": "video/mp4",
  "size_bytes": 1234567,
  "duration_seconds": 6,
  "created_at": "2026-06-26T08:00:00.000Z"
}

任务 succeeded 后，从 /v1/tasks/{task_id} 的 output.generated_reference_uri 取值，放入下一次 reference_video_urls。同一账号、成功任务且可复用的视频才会通过校验。

curl https://api.cgcm-api.com/v1/video/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-20260510-0002" \
  -d '{
  "model": "seedance-2.0",
  "prompt": "延续上一条视频的动作节奏，生成同风格的新镜头。",
  "reference_video_urls": [
    "asset://generated-video/job_xxx"
  ],
  "duration": 5,
  "aspect_ratio": "9:16",
  "resolution": "720p"
}'

为已开通 GPT 文本模型的账户创建对话响应，支持文字和图片输入。传 stream: true 时会返回 text/event-stream；视频、音频和通用文件会本地拒绝且不扣费。

curl -N https://api.cgcm-api.com/v1/chat/completions \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: chat-order-20260704-0001" \
  -d '{
  "model": "gpt-5.5",
  "messages": [
    {
      "role": "user",
      "content": "请把这段产品介绍改写成更适合短视频口播的版本。"
    }
  ],
  "max_completion_tokens": 800,
  "stream": true,
  "stream_options": {
    "include_usage": true
  }
}'

轮询任务状态，直到进入 succeeded、refunded、failed 或 canceled。Seedance 成功结果返回 usage.completion_tokens 与 usage.total_tokens，可用于下游计量；创建任务响应不包含 usage。

curl https://api.cgcm-api.com/v1/tasks/job_xxx \
  -H "Authorization: Bearer sk_live_xxx"

# 成功响应示例
{
  "id": "job_xxx",
  "object": "task",
  "status": "succeeded",
  "model": "seedance-2.0",
  "output": {
    "video_url": "https://cdn.example.com/users/usr_xxx/jobs/job_xxx/output/video.mp4",
    "generated_reference_uri": "asset://generated-video/job_xxx",
    "assets": [
      {
        "type": "output_video",
        "url": "https://cdn.example.com/users/usr_xxx/jobs/job_xxx/output/video.mp4",
        "mime_type": "video/mp4",
        "size_bytes": "12345678",
        "checksum": "sha256:..."
      }
    ]
  },
  "usage": {
    "completion_tokens": 40176,
    "total_tokens": 40176
  },
  "error": null,
  "cost": {
    "estimated_units": 1234567,
    "charged_units": 1234567,
    "refunded_units": 0,
    "currency": "credits"
  },
  "created_at": "2026-05-10T08:00:00.000Z",
  "finished_at": "2026-05-10T08:01:00.000Z"
}

仅限当前账号已成功的图片或视频任务。返回 data 数组，包含 asset_id、type、read_url、expires_at、method、mime_type、size_bytes 和 checksum；read_url 绕过 CDN，直接下载同一份成品。默认有效 5 分钟，以 expires_at 为准，过期后重新调用即可。使用 GET 下载，可带 Range，不要用 HEAD。原 output 链接与 Webhook 保持兼容，不重新生成或重复扣费。临时链接持有者可在到期前下载，请勿记录到日志或公开分享。

curl -X POST https://api.cgcm-api.com/v1/tasks/job_xxx/backup-links \
  -H "Authorization: Bearer sk_live_xxx"

succeeded 事件会包含 output；refunded、failed、canceled 的事件格式中 output 为 null，并包含 error。当前 MVP 请不要依赖非成功终态一定投递。

{
  "id": "evt_xxx",
  "type": "task.succeeded",
  "created_at": "2026-05-10T08:01:00.000Z",
  "data": {
    "id": "job_xxx",
    "status": "succeeded",
    "model": "seedance-2.0",
    "output": {
      "video_url": "https://cdn.example.com/users/usr_xxx/jobs/job_xxx/output/video.mp4"
    },
    "error": null
  }
}

示例使用 Node.js 内置 http 和 crypto。请将 SEEAPI_WEBHOOK_SECRET 配置为平台为你的回调地址分配的密钥。

import { createHmac, timingSafeEqual } from "node:crypto";
import http from "node:http";

const WEBHOOK_SECRET = process.env.SEEAPI_WEBHOOK_SECRET;

function verifySignature(rawBody, timestamp, signature) {
  if (!WEBHOOK_SECRET || !timestamp || !signature?.startsWith("v1=")) return false;

  const expected = "v1=" + createHmac("sha256", WEBHOOK_SECRET)
    .update(`${timestamp}.${rawBody}`)
    .digest("hex");

  const receivedBuffer = Buffer.from(signature);
  const expectedBuffer = Buffer.from(expected);
  return receivedBuffer.length === expectedBuffer.length
    && timingSafeEqual(receivedBuffer, expectedBuffer);
}

http.createServer((req, res) => {
  if (req.method !== "POST") {
    res.writeHead(405).end();
    return;
  }

  const chunks = [];
  req.on("data", (chunk) => chunks.push(chunk));
  req.on("end", () => {
    const rawBody = Buffer.concat(chunks).toString("utf8");
    const timestamp = req.headers["x-webhook-timestamp"];
    const signature = req.headers["x-webhook-signature"];

    if (!verifySignature(rawBody, String(timestamp ?? ""), String(signature ?? ""))) {
      res.writeHead(401).end("invalid signature");
      return;
    }

    const event = JSON.parse(rawBody);
    console.log(req.headers["x-webhook-id"], event.type, event.data.id);
    res.writeHead(204).end();
  });
}).listen(3000);

适用于 Node.js 18+，API Key 从服务端环境变量读取。

const BASE_URL = "https://api.cgcm-api.com";
const API_KEY = process.env.SEEAPI_API_KEY;

async function main() {
  const submit = await fetch(`${BASE_URL}/v1/video/generations`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${API_KEY}`,
      "Content-Type": "application/json",
      "Idempotency-Key": "order-20260510-0001"
    },
    body: JSON.stringify({
      "model": "seedance-2.0",
      "prompt": "基于产品参考图生成一段自然柔光下的展示视频。",
      "reference_image_urls": [
            "https://media.example.com/reference/product.jpg"
      ],
      "reference_video_urls": [
            "https://media.example.com/reference/action.mp4"
      ],
      "reference_audio_urls": [
            "https://media.example.com/reference/music.mp3"
      ],
      "duration": 5,
      "aspect_ratio": "9:16",
      "resolution": "720p",
      "count": 1,
      "generate_audio": true,
      "search_enabled": true,
      "callback_url": "https://client.example.com/webhooks/seeapi"
})
  });

  const task = await submit.json();
  if (!submit.ok) throw new Error(JSON.stringify(task));

  while (true) {
    const res = await fetch(`${BASE_URL}/v1/tasks/${task.id}`, {
      headers: { Authorization: `Bearer ${API_KEY}` }
    });
    const current = await res.json();
    if (!res.ok) throw new Error(JSON.stringify(current));

    if (["succeeded", "refunded", "failed", "canceled"].includes(current.status)) {
      console.log(current);
      return;
    }
    await new Promise((resolve) => setTimeout(resolve, 3000));
  }
}

main().catch((error) => {
  console.error(error);
  process.exitCode = 1;
});

示例使用 requests；API Key 从服务端环境变量 SEEAPI_API_KEY 读取。

import os
import time
import requests

BASE_URL = "https://api.cgcm-api.com"
API_KEY = os.environ["SEEAPI_API_KEY"]

payload = {
  "model": "seedance-2.0",
  "prompt": "基于产品参考图生成一段自然柔光下的展示视频。",
  "reference_image_urls": [
    "https://media.example.com/reference/product.jpg"
  ],
  "reference_video_urls": [
    "https://media.example.com/reference/action.mp4"
  ],
  "reference_audio_urls": [
    "https://media.example.com/reference/music.mp3"
  ],
  "duration": 5,
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "count": 1,
  "generate_audio": True,
  "search_enabled": True,
  "callback_url": "https://client.example.com/webhooks/seeapi"
}

headers = {
    "Authorization": f"Bearer {API_KEY}",
    "Content-Type": "application/json",
    "Idempotency-Key": "order-20260510-0001",
}

submit = requests.post(f"{BASE_URL}/v1/video/generations", json=payload, headers=headers, timeout=30)
submit.raise_for_status()
task = submit.json()

while True:
    res = requests.get(
        f"{BASE_URL}/v1/tasks/{task['id']}",
        headers={"Authorization": f"Bearer {API_KEY}"},
        timeout=30,
    )
    res.raise_for_status()
    current = res.json()
    if current["status"] in ["succeeded", "refunded", "failed", "canceled"]:
        print(current)
        break
    time.sleep(3)