快速开始

Aivora 开放 API 让你用一个 API Key 直接调用平台聚合的全部对话、图像、视频模型，按实际用量统一计费。下面用三步跑通第一个请求。

1. 获取 API Key

登录控制台，在 API 密钥页面创建一个密钥。密钥形如 sk-aivora-…，创建后只会完整展示一次，请妥善保存。认证细节见 API Key 认证。

2. Base URL

所有开放接口都在 /v1 前缀下，使用 HTTPS 调用：

Base URL

https://api.aivora.ai/v1

3. 发起第一个请求

用密钥拉取可调用的模型列表：

cURL

curl https://api.aivora.ai/v1/models \
  -H "Authorization: Bearer $AIVORA_API_KEY"

提交一个生成任务（以某个模型 ID 为例）：

cURL

curl https://api.aivora.ai/v1/generations \
  -H "Authorization: Bearer $AIVORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model_id": "1234567890",
    "prompt": "一只戴宇航头盔的柯基，赛博朋克风格"
  }'

响应结构

所有接口都返回统一信封：code 为 0 表示成功，非 0 时对照错误码说明；trace_id 用于排查问题时提供给技术支持。

Response

{
  "code": 0,
  "message": "ok",
  "data": { "id": "...", "status": "pending" },
  "trace_id": "..."
}

接口一览

GET /v1/models — 模型列表（支持 ?type= / ?q= 过滤）
GET /v1/models/:id — 模型详情与参数
POST /v1/generations — 提交生成任务
GET /v1/generations/:id — 查询任务状态与结果

可调用的模型及能力见模型列表。