SeeAPI 客户接入文档

curl https://api.example.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"
}

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

curl https://api.example.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"
}

curl https://api.example.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"
}'

curl https://api.example.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"
}'

curl https://api.example.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"
}'

curl https://api.example.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"
}'

curl https://api.example.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.example.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"
  ]
}'

curl https://api.example.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": [
    "asset://ref_image_xxx"
  ],
  "reference_video_urls": [
    "asset://ref_video_xxx"
  ],
  "reference_audio_urls": [
    "asset://ref_audio_mp3_xxx"
  ],
  "duration": 5,
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "count": 1,
  "mode": "mixed2video",
  "generate_audio": true,
  "search_enabled": true,
  "callback_url": "https://client.example.com/webhooks/seeapi"
}'

curl https://api.example.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": [
    "asset://ref_first_frame_xxx",
    "asset://ref_last_frame_xxx"
  ],
  "duration": 4,
  "aspect_ratio": "9:16",
  "resolution": "480p",
  "count": 1,
  "mode": "frames2video",
  "generate_audio": false
}'

curl https://api.example.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": [
    "asset://ref_image_xxx"
  ],
  "reference_video_urls": [
    "asset://ref_video_xxx"
  ],
  "reference_audio_urls": [
    "asset://ref_audio_xxx"
  ],
  "duration": 4,
  "aspect_ratio": "9:16",
  "resolution": "480p",
  "count": 1,
  "mode": "mixed2video",
  "generate_audio": true
}'

curl https://api.example.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
}'

curl https://api.example.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": [
    "asset://ref_image_xxx"
  ],
  "reference_video_urls": [
    "asset://ref_video_xxx"
  ],
  "reference_audio_urls": [
    "asset://ref_audio_xxx"
  ],
  "duration": 12,
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "count": 1,
  "mode": "mixed2video",
  "generate_audio": true,
  "search_enabled": true
}'

curl https://api.example.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": [
    "asset://ref_video_xxx"
  ],
  "reference_image_urls": [
    "asset://ref_image_xxx"
  ],
  "duration": 0,
  "aspect_ratio": "adaptive",
  "resolution": "720p",
  "count": 1,
  "mode": "videoEdit2video",
  "generate_audio": true,
  "search_enabled": true
}'

curl https://api.example.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"
}'

curl https://api.example.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.example.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
}'

curl https://api.example.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"
}'

curl https://api.example.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"
}'

curl -N https://api.example.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
  }
}'

curl https://api.example.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:..."
      }
    ]
  },
  "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"
}

curl https://api.example.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": [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": [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": {
        "type": "fixed_by_size_and_reference_count_tier",
        "currency": "credits",
        "unit": "credit_units",
        "prices": {
          "1K": { "retail": 300000 },
          "2K": { "retail": 600000 },
          "4K": { "retail": 600000 }
        },
        "exact_size_pixel_threshold": 2610000,
        "exact_size_prices": {
          "at_or_below_threshold": { "retail": 300000 },
          "above_threshold": { "retail": 600000 }
        },
        "additional_reference_prices": { "retail": 20000 },
        "included_reference_count": 1,
        "single_reference_field": "input_reference",
        "multiple_references_field": "input_references"
      }
    },
    {
      "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" }
    }
  ]
}

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

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

{
  "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
  }
}

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);

const BASE_URL = "https://api.example.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": [
            "asset://ref_image_xxx"
      ],
      "reference_video_urls": [
            "asset://ref_video_xxx"
      ],
      "reference_audio_urls": [
            "asset://ref_audio_mp3_xxx"
      ],
      "duration": 5,
      "aspect_ratio": "9:16",
      "resolution": "720p",
      "count": 1,
      "mode": "mixed2video",
      "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;
});

import os
import time
import requests

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

payload = {
  "model": "seedance-2.0",
  "prompt": "基于产品参考图生成一段自然柔光下的展示视频。",
  "reference_image_urls": [
    "asset://ref_image_xxx"
  ],
  "reference_video_urls": [
    "asset://ref_video_xxx"
  ],
  "reference_audio_urls": [
    "asset://ref_audio_mp3_xxx"
  ],
  "duration": 5,
  "aspect_ratio": "9:16",
  "resolution": "720p",
  "count": 1,
  "mode": "mixed2video",
  "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)