跳转到主要内容

​
1. OpenAI 兼容格式

适合大多数新接入场景，优先考虑：
  • POST /v1/chat/completions
  • POST /v1/responses
  • GET /v1/responses/{response_id}
  • POST /v1/images/generations
  • POST /v1/images/edits
  • POST /v1/videos
  • GET /v1/videos/{task_id}
特点：
  • SDK 生态成熟
  • 字段风格统一
  • 适合多模型切换

​
2. 模型原生格式

当模型本身需要专用字段、专用任务结构或原生查询协议时，公开原生接口：
  • Seedance：/api/v3/contents/generations/tasks
  • HappyHorse：/api/v1/services/aigc/video-generation/video-synthesis 和 /api/v1/tasks/{task_id}
  • Vidu：/ent/v2/text2video、/ent/v2/img2video、/ent/v2/start-end2video、/ent/v2/reference2video 和 /ent/v2/tasks/{task_id}/creations
  • Omni 与 Veo：gemini-omni 使用 /v1/videos 或 /api/v3/contents/generations/tasks；Veo 原生预留路径为 /v1beta/models/{model}:predictLongRunning 和 /v1beta/{operation_name}
  • Gemini 图片生成：/v1beta/models/{model}:generateContent
  • 音乐生成：/suno/submit/music 和 /suno/fetch/{task_id}，支持提示词描述模式、轻音乐/纯伴奏、歌词高级模式
gemini-omni 是对外公开的视频模型名，不需要关心内部上游模型；视频调用优先使用 /v1/videos，也可使用 Seedance 任务格式 /api/v3/contents/generations/tasks。mode=t2v/r2v/edit 分别表示文生视频、参考生成和视频编辑，时长字段会自动匹配到 4 / 6 / 8 / 10 秒档。 适合：
  • 模型特有字段较多
  • 需要原生请求体结构
  • 需要保持与上游官方格式接近

​
3. 模型专用视频接口

当前还公开少量模型专用接口，例如：
  • POST /kling/v1/videos/text2video
  • POST /kling/v1/videos/image2video 适合：
  • 已经基于对应模型专用协议集成
  • 需要使用该模型专用参数模式

​
4. 选择建议

  1. 新项目优先使用 OpenAI 兼容格式。
  2. 如果兼容格式无法覆盖模型特有字段，再切换到原生格式。
  3. 长任务接口应明确区分“创建接口”和“查询接口”，保存 task_id 或 operation_name。
  4. 同一模型存在多种调用格式时，以对应接口页的支持字段为准，不要混用请求体。