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

一套接口调用顶尖 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查询

模型

已上线模型

1 credit = $0.005。每个模型单价公开,按实际用量扣费。

ByteDance视频

Seedance 2.0

seedance-2.0

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

  • 文生视频
  • 图生视频
  • 音频

720p 文生视频

33credits/秒

5 秒视频约 $0.825

ByteDance视频

Seedance 2.0 Fast

seedance-2.0-fast

快速版本,请求结构与标准版相同。

  • 文生视频
  • 图生视频
  • 音频

720p 文生视频

33credits/秒

5 秒视频约 $0.825

更多模型接入中

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

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

快速接入

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

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

  1. 1

    登录并创建 Key

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

    打开控制台
  2. 2

    选择模型

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

    • seedance-2.0
    • seedance-2.0-fast
    查看已上线模型
  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

    透明计价

    每个模型的单价公开可查,按实际用量扣费,1 credit = $0.005。

  • 03

    结果保留 30 天

    所有产物都转存到我们自己的对象存储,保留 30 天,上游临时链接失效后仍可访问。

  • 04

    失败自动退款

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

  • 05

    回调会重投

    你的接口挂了我们会重试,每两分钟还有一次兜底扫描,捞回上游丢掉的回调。

  • 06

    一个控制台管到底

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

常见问题

常见问题

目前支持哪些模型?

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

怎么计费?

每个模型有公开单价,按实际用量扣费,1 credit = $0.005。提交时预扣,任务结束时结算。

视频支持哪些分辨率?

目前是 720p。更高档位等确认了上游成本再开——不想卖一个算不清成本的档位。

生成失败了怎么办?

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

结果文件能存多久?

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

必须接回调吗?

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

开始使用

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

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