LogoAPI in One
Dashboard

API 文档

将 API in One 集成到您的应用所需的一切。

身份验证

所有 API 请求都需要在 Authorization 请求头中携带 Bearer 令牌。您可以在仪表盘中管理 API 密钥。

http
Authorization: Bearer aio_your_api_key_here

获取您的 API 密钥: 在仪表盘的 API 密钥页面创建免费 API 密钥。新账户将获得赠送额度以探索平台。

基础 URL

https://apiin.one/api/v1

API 端点

POST/api/v1/images/generations
POST/api/v1/videos/generations
POST/api/v1/audio/music
POST/api/v1/audio/speech
POST/api/v1/chat/completions
POST/api/v1/images/tools/remove-bg
GET/api/v1/tasks/{task_id}

请求格式

所有请求使用 JSON 请求体，必须包含 'model' 字段来指定使用哪个 AI 模型。其他参数因模型而异。

json
{
  "model": "flux-2",
  "prompt": "A beautiful landscape",
  "...other_params": "..."
}

'model' 参数始终是必需的。请访问每个模型的文档页面查看完整的支持参数列表。

响应格式

异步任务（图像、视频、音乐、语音）

对于内容生成模型，API 会立即返回一个任务 ID。通过轮询状态端点来查看任务是否完成。

Initial response when task is created.

{
  "id": "task_abc123",
  "status": "pending",
  "model": "kling-3",
  "created_at": "2026-02-24T12:00:00Z"
}

同步响应（对话）

对话补全会在单个请求中直接返回响应，遵循 OpenAI 兼容格式。

json
{
  "id": "chatcmpl_xyz",
  "model": "gemini",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "..."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 156,
    "total_tokens": 168
  },
  "credits_consumed": 2
}

错误处理

所有错误返回一致的 JSON 格式，包含错误代码、消息和类型。

json
{
  "error": {
    "code": 401,
    "message": "Invalid API key",
    "type": "authentication_error"
  }
}
Status Code类型必填描述
400invalid_request可选请求参数无效。请查看模型文档了解必填字段。
401authentication_error可选API 密钥缺失、无效或已吊销。
402insufficient_credits可选账户额度不足。请购买更多额度以继续使用。
404not_found可选未找到请求的资源（任务、模型）。
429rate_limit可选超出速率限制。默认为每分钟 60 个请求。
500server_error可选服务器内部错误。请稍后重试。

快速开始

1. 获取 API 密钥

注册并在仪表盘中创建 API 密钥。免费账户包含赠送额度。

2. 发送第一个请求

bash
curl -X POST https://apiin.one/api/v1/images/generations \
  -H "Authorization: Bearer aio_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-2",
    "prompt": "A serene Japanese garden with cherry blossoms"
  }'

3. 查看任务状态（异步模型）

bash
curl https://apiin.one/api/v1/tasks/task_abc123 \
  -H "Authorization: Bearer aio_your_key"

4. 探索更多模型

浏览我们的模型目录，找到最适合您用例的 AI 模型。

浏览所有模型 →

API Tester

Test the API directly from your browser:

API 测试沙盒POST