AI 图片生成与视频生成 API 汇总对比及调用指南

生图模型统一走 OpenAI Images 接口(generations / edits),视频模型统一走 /v1/videos 异步提交与轮询下载,全部与文本模型共用同一账户余额并按次计费。

多模态媒体 API 接口总览

不要把生图或视频模型发送到文本对话端点(/v1/responses、/v1/messages 或 /v1/chat/completions)。在深云 DeepClub,图片与视频均使用专用媒体接口:

媒体类型 在售代表模型 接入端点 计费方式
商业排版与多图参考 gpt-image-2、gpt-image-2-adobe、gpt-image-2.5-flare、gpt-image-2.5-sunburst /v1/images/generations · /v1/images/edits 按张/按次
写实光影与电商批量图 gemini-3-pro-image、gemini-3.1-flash-image /v1/images/generations · /v1/images/edits 按张/按次
插画、UI 与多视角角色一致 nano-banana-2、nano-banana-pro /v1/images/generations · /v1/images/edits 按张/按次
短视频生成与分镜预演 Seedance-2.0-Mini、Seedance-2.0-Fast、MiniMax-H3 POST /v1/videos + GET /v1/videos/{task_id} 按次(随分辨率/时长)

1. Python OpenAI SDK 调用 AI 生图 API

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://deepclub.net/v1",
    api_key=os.environ["DEEPCLUB_API_KEY"],
)

result = client.images.generate(
    model="gpt-image-2",
    prompt="极简咖啡品牌宣传海报,居中留白,高质量商业摄影质感",
    size="1024x1024",
)
print(result.data[0].url or result.data[0].b64_json[:64])

横向效果对比可参见:Gemini 3 Pro Image vs GPT Image 2 生图对比。

2. AI 视频生成 API 异步三步调用流程

视频任务耗时较长,必须采用「提交任务 → 保存 task_id 轮询 → 下载 MP4」流程,避免网络超时重复提交导致重复扣费:

# 1) 提交异步任务并立即保存返回的 id
curl https://deepclub.net/v1/videos \
  -H "Authorization: Bearer $DEEPCLUB_API_KEY" \
  -F model=Seedance-2.0-Fast \
  -F prompt="Slow dolly zoom over a misty mountain lake at sunrise" \
  -F seconds=5

# 2) 轮询任务状态(queued / in_progress / completed / failed)
curl https://deepclub.net/v1/videos/$TASK_ID \
  -H "Authorization: Bearer $DEEPCLUB_API_KEY"

# 3) completed 后下载视频文件
curl -o output.mp4 https://deepclub.net/v1/videos/$TASK_ID/content \
  -H "Authorization: Bearer $DEEPCLUB_API_KEY"

视频参数与场景选择详见:Seedance 2.0 vs MiniMax-H3 视频 API 对比,各分辨率与秒数实时单价见 模型定价表。

常见问题

图片和视频生成模型支持 2K / 4K 或不同秒数吗?
不同模型开放的分辨率(如 1K/2K/4K)和视频时长(如 5 秒或 10 秒)规格不同,请在 /pricing 点击对应模型 ID 查看其发布的参数规格与对应单价。
轮询视频任务状态时超时了怎么办?
只要在第一步 POST /v1/videos 时持久化保存了返回的 task_id,后续通过 GET /v1/videos/{task_id} 查询与下载不会重复计费;切勿直接重试 POST 创建新任务。
调用生图模型时报错不支持 size 参数怎么排查?
请前往 /pricing 查看该图片模型当前公布支持的 size 规格列表,确保请求参数落在模型规格范围内。

更新于