LogoRuxa.ai
Ruxa AI API 入门指南
2025/12/30
2 分钟阅读

Ruxa AI API 入门指南

完整的 Ruxa AI 统一 API 集成指南 - Sora 2 视频生成、Nano Banana 图像生成等。

什么是 Ruxa AI?

Ruxa AI 提供统一的 API 平台,用于访问 AI 生成模型。通过单一 API 端点,您可以使用 Sora 2 生成视频,使用 Nano Banana(基于 Gemini 2.5 Flash Image)生成图像。

API 端点

所有生成任务使用相同的端点:

POST https://api.ruxa.ai/api/v1/tasks/create

认证

在请求头中添加您的 API Key:

Authorization: Bearer sk-xxxxxx

控制台获取您的 API Key。

快速开始:生成图像

使用 Nano Banana 生成图像:

curl --request POST \
  --url https://api.ruxa.ai/api/v1/tasks/create \
  --header 'Authorization: Bearer sk-xxxxxx' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "google/nano-banana",
    "input": {
      "prompt": "日落时分的未来城市景观,赛博朋克风格",
      "output_format": "png",
      "image_size": "16:9"
    }
  }'

响应:

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "task_gemini-2.5-flash-image_xxxxx"
  }
}

查询任务状态

创建任务后,查询其状态:

curl --request GET \
  --url 'https://api.ruxa.ai/api/v1/tasks/query/{taskId}' \
  --header 'Authorization: Bearer sk-xxxxxx'

可用模型

模型 类型 描述
google/nano-banana 图像 Gemini 2.5 Flash Image - 快速文生图
google/nano-banana-pro 图像 更高分辨率,支持图像编辑
sora-2 视频 OpenAI Sora 2 - 文本/图像生成视频
sora-2-hd 视频 Sora 2 HD - 更高分辨率输出

回调 URL(推荐)

生产环境建议使用回调而非轮询:

{
  "model": "google/nano-banana",
  "callBackUrl": "https://your-app.com/api/webhook",
  "input": {
    "prompt": "您的提示词"
  }
}

生成完成后,系统会将结果 POST 到您的回调 URL。

响应状态码

状态码 描述
200 成功
401 未授权 - API Key 无效
402 积分不足
422 验证错误
429 速率限制
500 服务器错误

下一步

作者

avatar for Ruxa AI
Ruxa AI

邮件列表

加入我们的社区

订阅邮件列表,及时获取最新消息和更新