跳转到主要内容
AIReiter 是一个统一的 AI 内容生成 API 平台,提供图像和视频生成服务。通过简单的 REST API 调用,即可使用 GPT-4o、Gemini、Sora2、VEO3 等多种主流 AI 模型生成高质量的图像和视频内容。

快速开始

API 工作流程

1. 提交生成任务

所有图像和视频生成都采用异步处理模式。提交任务时需要传入 out_task_id(发起方任务ID),系统会返回 task_idout_task_id
curl --request POST \
  --url https://test.aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_4o",
    "params": {
      "prompt": "一只可爱的猫咪在花园里",
      "aspect_ratio": "1:1"
    },
    "out_task_id": "my_task_123456"
  }'

2. 查询任务状态

使用返回的 task_id 或您提交时的 out_task_id 查询任务进度和结果(二选一):
# 使用 task_id 查询
curl --request POST \
  --url https://test.aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "task_id": "order_xxxxxxxxxxxx"
  }'

# 或使用 out_task_id 查询
curl --request POST \
  --url https://test.aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "out_task_id": "my_task_123456"
  }'

3. 获取生成结果

任务完成后,响应中会包含生成的图像或视频 URL:
{
  "statusCode": 200,
  "message": "",
  "data": {
    "task_id": "order_xxxxxxxxxxxx",
    "out_task_id": "my_task_123456",
    "status": "completed",
    "output": [
      {
        "url": "https://s1.pxz.ai/upload/image-generator/xxx.jpeg"
      }
    ]
  }
}

支持的模型

图像生成系列

AIReiter 提供多种图像生成模型,支持文本生成图像和图生图功能:

视频生成系列

支持文本生成视频和图生视频,提供多种分辨率和时长选项:

核心功能

异步任务处理

所有生成请求采用异步处理模式,避免长时间等待:
  • 提交任务时需传入 out_task_id(发起方任务ID,用于业务标识)
  • 立即返回系统生成的 task_id 和您提交的 out_task_id
  • 可使用 task_idout_task_id 查询任务状态(二选一)
  • 支持 webhook 回调通知(可选)
  • 任务状态实时更新:pendingprocessingcompleted

多模型支持

一个统一的 API 端点,支持多种图像和视频生成模型:
  • 图像生成:GPT-4o、Gemini、Seedream 等 5 个模型
  • 视频生成:Sora2、VEO3 等 4 个模型
  • 统一的请求格式和响应结构
  • 灵活的参数配置

透明定价

按积分计费,透明清晰:
  • 每个任务返回预估消耗积分
  • 任务完成后显示实际消耗积分
  • 只为成功生成的内容付费
  • 无隐藏费用

灵活配置

支持多种生成参数配置:
  • 图像:多种宽高比(1:1、3:2、2:3)
  • 视频:多种宽高比(16:9、9:16)、时长(10秒、15秒)、分辨率
  • 支持参考图像(图生图、图生视频)
  • 自定义元数据(metadata)

认证方式

所有 API 请求都需要使用 Bearer Token 进行认证:
Authorization: Bearer YOUR_API_KEY
获取 API Key: 访问 API Key 管理页面 获取您的 API Key。

常见问题

访问 API Key 管理页面,登录后即可创建和管理您的 API Key。
所有生成任务都是异步处理的。图像生成通常需要几秒到几十秒,视频生成根据时长和分辨率,通常需要 1-5 分钟。提交任务后会立即返回 task_id,您可以通过状态查询 API 跟踪进度。
使用任务状态查询 API,可以传入提交任务时返回的 task_id,或者您自己设置的 out_task_id(二选一):
POST https://test.aireiter.com/api/openapi/query
查看 任务状态查询文档 了解详情。
out_task_id 是发起方任务ID,由您在提交任务时自定义设置:
  • 必填参数:提交任务时必须传入 out_task_id
  • 业务标识:可以使用您系统中的订单号、业务ID等作为标识
  • 查询灵活:可以直接使用 out_task_id 查询任务状态,无需保存系统返回的 task_id
  • 结果关联:在查询结果中会同时返回 task_idout_task_id,方便您关联业务数据
是的,在提交任务时可以传入 callback_url 参数。任务完成后,系统会向该地址发送 POST 请求,包含完整的任务结果。
AIReiter 采用积分制计费:
  • 提交任务时返回预估消耗积分(estimated_credits
  • 任务完成后返回实际消耗积分(credits_used
  • 只为成功生成的内容付费,失败任务不收费
  • 不同模型的积分消耗不同
  • 图像:支持 JPEG、PNG 等常见格式
  • 视频:输出 MP4 格式
  • 参考图像:输入支持公开可访问的图像 URL

下一步