
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 | 服务器错误 |
下一步
更多文章
邮件列表
加入我们的社区
订阅邮件列表,及时获取最新消息和更新



