跳转至

API 手册

欢迎使用 12API 接口文档。本文档提供了所有可用 API 端点的详细说明。

Base URL（推荐）

推荐使用 CDN 线路，稳定性更好：

  • CDN 线路（推荐）: https://cdn.12ai.org

更多可用的接入点请参考 快速开始 页面。

推荐模型

  • OpenAI 格式: gpt-5.1（推荐）
  • Gemini 格式: gemini-3-pro-preview（推荐）

认证方式

OpenAI 格式 - Header 认证：

Authorization: Bearer <YOUR_API_KEY>

Claude 格式 - Header 认证：

Authorization: Bearer <YOUR_API_KEY>
anthropic-version: 2023-06-01

Gemini 格式 - URL 参数认证：

?key=<YOUR_API_KEY>

可用接口

OpenAI 兼容

文本

方法 端点 说明
POST /v1/chat/completions 创建对话模型响应

Claude 原生格式

方法 端点 说明
POST /v1/messages Claude Messages API（原生格式）

Response API

方法 端点 说明
POST /v1/responses 创建模型响应
GET /v1/responses/{response_id} 获取模型响应
DELETE /v1/responses/{response_id} 删除模型响应
POST /v1/responses/{response_id}/cancel 取消模型响应

视频

方法 端点 说明
POST /v1/videos 创建视频生成任务
GET /v1/videos/{id} 查询视频任务状态
DELETE /v1/videos/{id} 删除视频任务

Gemini 格式

文本生成

方法 端点 说明
POST /v1beta/models/{model}:generateContent 生成内容
POST /v1beta/models/{model}:streamGenerateContent 流式生成内容

图片生成 (NanoBanana)

方法 端点 说明
POST /v1beta/models/gemini-2.5-flash-image:generateContent Nano Banana - 快速图片生成
POST /v1beta/models/gemini-3-pro-image-preview:generateContent Nano Banana Pro - 高分辨率图片生成

快速开始

1. 获取 API Key

前往 站点注册 获取您的 API Key。

2. 发送第一个请求

curl https://cdn.12ai.org/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.1",
    "messages": [
      {"role": "user", "content": "你好！"}
    ]
  }'

curl "https://cdn.12ai.org/v1beta/models/gemini-3-pro-preview:generateContent?key=$API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "contents": [{
      "parts": [{"text": "你好！"}]
    }]
  }'

from openai import OpenAI

client = OpenAI(
    api_key="your-api-key",
    base_url="https://cdn.12ai.org/v1"
)

response = client.chat.completions.create(
    model="gpt-5.1",
    messages=[
        {"role": "user", "content": "你好！"}
    ]
)

print(response.choices[0].message.content)

import os
from google import genai

os.environ["GOOGLE_GEMINI_BASE_URL"] = "https://cdn.12ai.org"

client = genai.Client(api_key="your-api-key")

response = client.models.generate_content(
    model="gemini-3-pro-preview",
    contents="你好！",
)

print(response.text)

更多资源