{
  "openapi": "3.1.0",
  "info": {
    "title": "aicentos API",
    "version": "1.0.0",
    "summary": "面向开发者的 AI API 中转聚合平台，一个 API Key 统一调用多家大模型。",
    "description": "aicentos API 聚合 OpenAI、Anthropic、Google、xAI 等模型，兼容 OpenAI 协议，同时提供 Claude 原生与 Gemini 原生格式。本文档为端点概览：请求/响应字段详见 https://docs.aicentos.com/llms.txt 收录的接口文档。所有接口使用 Bearer API Key 认证，Base URL 为 https://aicentos.com/v1（Gemini 原生格式为 https://aicentos.com/v1beta）。",
    "contact": {
      "url": "https://docs.aicentos.com"
    }
  },
  "servers": [
    {
      "url": "https://aicentos.com",
      "description": "生产环境"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "chat",
      "description": "对话补全：OpenAI、Anthropic、Gemini 三种协议"
    },
    {
      "name": "images",
      "description": "图像生成与编辑"
    },
    {
      "name": "models",
      "description": "模型列表查询"
    },
    {
      "name": "videos",
      "description": "视频生成任务：创建、查询、获取内容"
    }
  ],
  "paths": {
    "/v1/chat/completions": {
      "post": {
        "tags": ["chat"],
        "operationId": "createChatCompletion",
        "summary": "创建对话补全（OpenAI 兼容）",
        "description": "OpenAI Chat Completions 格式。文档：https://docs.aicentos.com/api/chat/openai/chat-completions",
        "responses": {
          "200": {
            "description": "补全结果，兼容 OpenAI chat.completion 格式"
          }
        }
      }
    },
    "/v1/responses": {
      "post": {
        "tags": ["chat"],
        "operationId": "createResponse",
        "summary": "创建 Responses 任务（OpenAI 兼容）",
        "description": "OpenAI Responses API 格式，支持流式输出。文档：https://docs.aicentos.com/api/chat/openai/responses",
        "responses": {
          "200": {
            "description": "Responses 结果，兼容 OpenAI response 格式"
          }
        }
      }
    },
    "/v1/messages": {
      "post": {
        "tags": ["chat"],
        "operationId": "createMessage",
        "summary": "创建消息（Anthropic Messages 原生格式）",
        "description": "Claude 原生 Messages 格式，可直接复用 Anthropic SDK（替换 Base URL）。文档：https://docs.aicentos.com/api/chat/claude",
        "responses": {
          "200": {
            "description": "消息结果，兼容 Anthropic message 格式"
          }
        }
      }
    },
    "/v1beta/models/{model}:generateContent": {
      "post": {
        "tags": ["chat"],
        "operationId": "generateContent",
        "summary": "生成内容（Gemini 原生格式）",
        "description": "Gemini generateContent 原生格式，可直接复用 Google SDK（替换 Base URL）。文档：https://docs.aicentos.com/api/chat/gemini/text",
        "parameters": [
          {
            "name": "model",
            "in": "path",
            "required": true,
            "description": "模型名，如 gemini-2.0-pro",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "生成结果，兼容 Gemini GenerateContentResponse 格式"
          }
        }
      }
    },
    "/v1/images/generations": {
      "post": {
        "tags": ["images"],
        "operationId": "createImage",
        "summary": "生成图像（OpenAI 兼容）",
        "description": "文生图接口，通过 model 参数选择模型。文档：https://docs.aicentos.com/api/images/openai/generations",
        "responses": {
          "200": {
            "description": "图像生成结果（URL 或 base64）"
          }
        }
      }
    },
    "/v1/images/edits": {
      "post": {
        "tags": ["images"],
        "operationId": "editImage",
        "summary": "编辑图像（OpenAI 兼容）",
        "description": "基于已有图像与指令编辑，multipart 上传。文档：https://docs.aicentos.com/api/images/openai/edits",
        "responses": {
          "200": {
            "description": "图像编辑结果（URL 或 base64）"
          }
        }
      }
    },
    "/v1/models": {
      "get": {
        "tags": ["models"],
        "operationId": "listModels",
        "summary": "查询可用模型列表（OpenAI 兼容）",
        "description": "返回当前账号可用的模型。文档：https://docs.aicentos.com/api/models/openai",
        "responses": {
          "200": {
            "description": "模型列表，兼容 OpenAI list models 格式"
          }
        }
      }
    },
    "/v1beta/models": {
      "get": {
        "tags": ["models"],
        "operationId": "listModelsGemini",
        "summary": "查询可用模型列表（Gemini 原生格式）",
        "description": "Gemini 原生格式的模型列表。文档：https://docs.aicentos.com/api/models/gemini",
        "responses": {
          "200": {
            "description": "模型列表，兼容 Gemini ListModelsResponse 格式"
          }
        }
      }
    },
    "/v1/videos": {
      "post": {
        "tags": ["videos"],
        "operationId": "createVideo",
        "summary": "创建视频生成任务",
        "description": "同一端点通过 model 参数区分视频模型（Sora、Dreamina 等），返回任务 ID。文档：https://docs.aicentos.com/api/videos/sora/create",
        "responses": {
          "200": {
            "description": "任务 ID 与初始状态"
          }
        }
      }
    },
    "/v1/videos/{task_id}": {
      "get": {
        "tags": ["videos"],
        "operationId": "getVideoTask",
        "summary": "查询视频任务进度",
        "description": "按任务 ID 查询生成进度与结果。文档：https://docs.aicentos.com/api/videos/sora/get-task",
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "任务状态与结果"
          }
        }
      }
    },
    "/v1/videos/{task_id}/content": {
      "get": {
        "tags": ["videos"],
        "operationId": "getVideoContent",
        "summary": "获取视频内容",
        "description": "任务完成后获取视频文件内容。文档：https://docs.aicentos.com/api/videos/sora/get-content",
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "视频文件内容"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "在 aicentos 控制台创建的 API Key，形式为 Authorization: Bearer <API Key>"
      }
    }
  }
}