从请求到结果，一条路径接入 seeAPI

重点覆盖 Image 2、Grok、Seedance 2.0，以及全部当前公开图片和视频模型。示例只使用推荐的客户请求方式。

开始接入

基础地址https://api.example.com

鉴权Authorization: Bearer sk_live_...

幂等Idempotency-Key: business-request-id

五分钟接入

在自己的后端安全保存 API Key。
调用 GET /v1/models，读取当前可见模型和 input_schema。
每个生成请求都带业务侧唯一 Idempotency-Key。
图片同步读取 data；视频取得 task ID 后轮询 GET /v1/tasks/{id}。

相同幂等键与相同请求体返回原结果；相同键搭配不同请求体返回 409 idempotency_conflict。

模型与入口

model	分类	创建接口	模式	能力
`image-2-lite`	图片	`POST /v1/images/generations`	同步	1–4 张参考图
`image-2-std`	图片	`POST /v1/images/generations`	同步	1–4 张参考图，含 4K 与方图
`image-2-pro`	图片	`POST /v1/images/generations`	同步	1–4 张参考图，含 4K
`nano-banana-flash`	图片	`POST /v1/images/generations`	同步	1K / 2K / 4K
`nano-banana-pro`	图片	`POST /v1/images/generations`	同步	1K / 2K / 4K
`seedance-2.0`	视频	`POST /v1/video/generations`	异步	480p–4K，多素材参考
`seedance-2.0-fast`	视频	`POST /v1/video/generations`	异步	480p / 720p，多素材参考
`grok-imagine-video`	视频	`POST /v1/videos`	异步	单图参考生视频

未携带 API Key 查询时，价格字段显示 Retail 标准公开价；携带 API Key 后，显示、报价与实际扣费均按该 Key 所属客户分组。模型列表中的公开价格不是对所有账户统一扣费。

文本模型只在账户的 GET /v1/models 返回后接入；本页不复制未公开的历史 model 名。

Image 2

推荐方式：把 1–4 个公开可访问的 HTTPS 图片 URL 放入 input_references。单图也使用数组。

URL 使用 HTTPS，最长 4096 字符，无需登录、Cookie 或自定义 Header。
图片为 PNG、JPEG/JPG 或 WebP，URL 在请求处理期间保持有效。
不要同时传 input_reference 与 input_references。
同一数组只能全部使用 HTTPS URL，或全部使用 Data URL；混合两种形式会在计费和创建任务前返回 HTTP 400。
纯 Data URL 数组和旧单图字段仅用于兼容；新接入统一使用 input_references。
image-2-lite 不接受 asset://；Image 2 参考图不要使用 Seedance 的 asset_uri。

成功响应的 data 项可能包含 url，也可能包含 b64_json。客户代码必须兼容两种合法结果：优先读取存在的字段，不要假设所有模型都固定返回同一种形式。

POST/v1/images/generations

Image 2 参考图生成

curl "https://api.example.com/v1/images/generations" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: image-20260720-0001" \
  -d '{
    "model": "image-2-pro",
    "prompt": "保持产品外观一致，生成高端商业摄影场景。",
    "size": "2160x3840",
    "input_references": [
      "https://assets.example.com/reference-product.png"
    ],
    "n": 1,
    "response_format": "b64_json",
    "quality": "auto",
    "output_format": "png",
    "moderation": "auto"
  }'

Grok

推荐方式：input_reference 填写一个公开可访问的 HTTPS 图片 URL。

仅支持单张 PNG、JPEG/JPG 或 WebP 参考图。
seconds 为 4–15 的整数。
size 为 1280x720 或 720x1280。
不支持纯文字生视频，也不接收多张参考图。

POST/v1/videos

Grok 图片参考生视频

curl "https://api.example.com/v1/videos" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: grok-video-20260720-0001" \
  -d '{
    "model": "grok-imagine-video",
    "prompt": "让画面产生自然的电影感推进，保持主体一致。",
    "input_reference": "https://assets.example.com/reference-frame.webp",
    "seconds": 6,
    "size": "1280x720"
  }'

Seedance 2.0

标准方式：先上传参考素材，再把返回的 asset_uri 放入对应的参考数组。

素材	格式	单文件	Standard / Fast
图片	JPEG、PNG、WebP	≤10 MiB；≤8000 px；≤2500 万像素	最多 9
视频	MP4、MOV	≤100 MiB；≤15 秒	最多 3
音频	仅 MP3、WAV	≤25 MiB	最多 3

seedance-2.0（Standard）公开支持 480p、720p、1080p、4K；seedance-2.0-fast 支持 480p、720p。
音频不能单独使用，至少同时提供图片或视频。
AAC、M4A、OGG、WebM 等音频格式不在客户合同内，会在计费和创建任务前拒绝。
完整版与快速版的参考视频至少 409,600 像素。
不要直接填写本地路径、任意素材 URL 或旧 portrait URI。
mode 支持 text2video、singleImage2video、frames2video、image2video、mixed2video；不支持纯音频模式。

POST/v1/assets/references/upload

上传 Seedance 参考素材

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

POST/v1/video/generations

提交 Seedance 多素材任务

curl "https://api.example.com/v1/video/generations" \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: seedance-20260720-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_xxx"],
    "duration": 6,
    "aspect_ratio": "9:16",
    "resolution": "720p",
    "count": 1,
    "mode": "mixed2video"
  }'

任务与结果

视频创建返回 HTTP 202 和 task ID。建议每 3–5 秒查询一次，进入 succeeded、refunded、failed 或 canceled 后停止。

成功时读取 output.video_url。
Seedance 的成功结果还可能返回可复用的 generated_reference_uri。
Grok 可以使用 GET /v1/videos/{id}，也可以使用公共任务查询接口。
配置 callback_url 后仍以任务查询作为最终状态兜底。

GET/v1/tasks/{id}

查询视频任务

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

错误与自检

错误	处理
`400 validation_error`	按实时 schema 检查字段、枚举、素材类型、组合与归属。
`401 invalid_api_key`	检查 Bearer 格式与 Key 是否完整。
`402 insufficient_credits`	补充额度，不要连续提交。
`404 task_not_found`	检查 task ID 与当前账户。
`409 idempotency_conflict`	复用原请求体，或为新请求换新键。
`413 storage_file_too_large`	按素材单文件上限压缩或替换。
`5xx`	先查原任务；保留 request ID 和 task ID 联系支持。

上线前确认：Image 2 与 Grok 使用公开 HTTPS URL；Seedance 使用上传后返回的 asset URI；所有生成请求有唯一幂等键；日志不记录 API Key 与完整素材 URL。