统一接口 · 更多模型陆续接入

一套接口调用顶尖 AI 生成模型

统一的任务式 API:提交任务,轮询状态或接收回调。生成结果保留 30 天,任务失败自动全额退款,新模型接入后沿用同一套接口。

  • 1 个 Key

    调用全部已接入模型

  • 100%

    任务失败退回全部 credits

  • 2 分钟

    一次回调兜底扫描

  • 30 天

    结果文件保留期

为什么靠得住

能直接上生产的 AI API 网关

接入、计费、交付都在网关层处理好,你的代码只需要关心生成结果。

01

统一接口

所有模型共用同一套任务接口,换模型只改 model 字段。

  • 同一个端点
  • 同一套请求结构
  • 同一套响应结构
  • 同一套回调

02

计费可以对账

提交时预扣,任务结束时结算,每一笔变动都记在流水里。

  1. 提交预扣
  2. 失败全额退回
  3. 按实际用量计价
  4. 完整消费流水

03

覆盖任务全生命周期

从提交到交付,最容易出问题的环节都由网关兜住。

  1. 01提交
  2. 02排队
  3. 03生成
  4. 04存储
  5. 05回调
  6. 06查询

模型

已上线模型

所有模型都通过同一套任务接口调用。

ByteDance视频

Seedance 2.0

seedance-2.0

字节跳动的视频生成模型,支持文生视频与首尾帧图生视频,时长 4–15 秒。

  • 文生视频
  • 图生视频
  • 音频
查看模型 ↗
ByteDance视频

Seedance 2.5

seedance-2.5

Seedance 2.5 国内线路,支持文字、首尾帧和多模态参考,时长 4 至 30 秒,可仅用音频参考,最多 30 张参考图。

  • 文生视频
  • 图生视频
  • 音频
查看模型 ↗
ByteDance视频

Seedance 2.5 Global

seedance-2.5-global

Seedance 2.5 海外线路,支持文生视频、首尾帧和多模态参考,时长 4 至 30 秒,最多 30 张参考图。

  • 文生视频
  • 图生视频
  • 音频
查看模型 ↗
MiniMax视频

MiniMax H3

hailuo-h3

MiniMax H3,支持首尾帧和图、视频、音频参考,输出 768p 或 2K 视频,时长 5 至 15 秒。

  • 文生视频
  • 图生视频
  • 音频
查看模型 ↗

更多模型接入中

图像、视频等更多生成模型正在陆续接入,沿用同一套接口,你的集成代码不需要改。

视频模型目前开放 480p 和 720p。任务失败全额退回。

快速接入

三步,从登录到拿到第一个结果

所有模型共用一套接口,换模型只改一个字段。

  1. 1

    登录并创建 Key

    进入控制台,创建 API Key 并充值 credits。

    打开控制台
  2. 2

    选择模型

    在 model 字段填入模型 ID,请求的其余部分保持不变。

    • seedance-2.0
    • seedance-2.0-fast
    • seedance-2.0-global
    • seedance-2.0-fast-global
    • seedance-2.5
    • seedance-2.5-global
    • hailuo-h3
    查看已上线模型
  3. 3

    提交任务

    创建任务后轮询查询接口,或者等待回调通知。

    创建任务接口说明
创建任务
curl -X POST https://api.xbaiapi.com/api/v1/jobs/createTask \
  -H "Authorization: Bearer xb-your-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "input": {
      "prompt": "a cat stretching on a sunlit windowsill",
      "duration": 5
    }
  }'

细节

除了模型本身,你还能得到什么

接入视频生成时最费时间的那些环节。

  • 01

    接入一次

    任务、查询、回调对所有模型都一样,新模型上线即可直接调用。

  • 02

    透明计价

    每个模型的单价都在文档里公开可查,按实际用量扣费。

  • 03

    结果保留 30 天

    所有产物都存进我们自己的对象存储,保留 30 天,期间链接一直有效。

  • 04

    失败自动退款

    提交时预扣,任务一失败就全额退回。你不会为没拿到的结果付钱。

  • 05

    回调会重投

    你的接口挂了我们会重试,每两分钟还有一次兜底扫描,补发没送达的回调。

  • 06

    一个控制台管到底

    密钥、任务、用量、账单集中在一处,每个任务扣了多少一目了然。

常见问题

常见问题

目前支持哪些模型?

见上方「已上线模型」。更多模型正在陆续接入,新模型沿用同一套接口。

怎么计费?

每个模型的单价在文档里公开,按实际用量扣费。提交时预扣,任务结束时结算。

视频支持哪些分辨率?

目前支持 480p 和 720p,默认 720p。

生成失败了怎么办?

预扣的 credits 全额自动退回,在消费流水里能看到这笔退款记录。

结果文件能存多久?

从任务创建起保留 30 天,到期后文件会被删除。需要长期保存的请在此之前转存到你自己的存储。

必须接回调吗?

不必须。不填回调地址时,用任务 ID 轮询查询接口即可。填了回调地址,投递失败会自动重试。

开始使用

一套接口,接入之后的每一个模型

登录、创建 Key、提交第一个任务。