프로덕션 AI 트래픽을 위한 단일 게이트웨이

하나의 Base URL로 중국 AI 모델에 연결하세요.

ChinaAPI는 DeepSeek, Qwen, GLM, Kimi, Doubao와 이미지, 동영상, 임베딩, 리랭크 모델을 위한 단일 OpenAI 호환 엔드포인트를 제공합니다. SDK는 그대로 유지한 채 엔드포인트만 교체하고, 하나의 대시보드에서 사용량을 관리하세요.

OpenAI SDK로 시작하기 콘솔 열기

연결

https://api.chinaapi.ai

1 API 키

OpenAI 호환

40+ 제공업체

팁 SDK의 base URL을 https://api.chinaapi.ai/v1로 설정하고, ChinaAPI 토큰을 bearer 키로 사용하세요.

인증

모든 API 요청은 bearer 토큰 인증을 사용합니다. 대시보드에서 토큰을 생성한 뒤 Authorization 헤더에 담아 전송하세요.

HTTP headers

Authorization: Bearer $CHINAAPI_KEY
Content-Type: application/json

지원 프로토콜

애플리케이션이 이미 사용 중인 요청 형식을 선택하세요. 하나의 ChinaAPI 키와 Base URL로 세 가지 프로토콜 계열을 모두 이용할 수 있습니다.

OpenAI

/v1/chat/completions

OpenAI SDK, Cherry Studio, Cline, Open WebUI 등 대부분의 도구 클라이언트에서 사용할 수 있습니다.

Gemini

/v1beta/models/{model}:generateContent

애플리케이션이 Gemini 요청 구조에 의존한다면 Gemini 호환 클라이언트를 사용하세요.

Claude

/v1/messages

동일한 게이트웨이 키와 쿼터 제어를 유지한 채 Claude Messages API 페이로드를 라우팅합니다.

지원 모델 제공업체

ChinaAPI는 카탈로그에 이미 게시된 중국 모델 제공업체를 하나로 통합합니다. 사용 가능 여부, 별칭, 가격은 계정의 대시보드에서 확인할 수 있습니다.

DeepSeek Qwen GLM Kimi Doubao MiniMax

지원 모델 유형

모델 유형을 먼저 선택한 뒤, 대시보드에서 사용 가능한 모델 별칭을 고르세요. 유형마다 요청 형식과 과금 기준이 다릅니다.

LLM

추론 및 채팅

텍스트 생성, 도구 호출, 구조화된 출력, 선택적 추론 제어를 지원합니다.

Image

이미지 생성

모델별 크기와 품질 옵션을 갖춘 프롬프트 기반 이미지 생성 요청입니다.

Video

동영상 생성

길이, 해상도, 모델별 품질 설정을 지정하는 비동기 생성입니다.

Audio

ASR 및 TTS

오디오를 업로드해 텍스트로 변환하거나, 텍스트로 음성을 생성하세요.

Embedding

검색 및 조회

검색을 위한 벡터를 생성하고 후보 문서를 리랭크합니다.

LLM 통합

대부분의 OpenAI 클라이언트는 baseURL만 변경하면 그대로 동작합니다. ChinaAPI 대시보드에 게시된 모델 이름을 사용하세요.

주요 파라미터: model과 messages는 필수입니다. 생성 동작에는 temperature, top_p, max_tokens, stream을 사용하세요. 선택한 추론 모델이 지원하는 경우 reasoning_effort에 low, medium, high 또는 모델별 값을 지정할 수 있습니다.

curl

curl https://api.chinaapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [
      { "role": "user", "content": "Hello" }
    ],
    "temperature": 0.7,
    "max_tokens": 1024
  }'

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.CHINAAPI_KEY,
  baseURL: "https://api.chinaapi.ai/v1",
});

const result = await client.chat.completions.create({
  model: "deepseek-chat",
  messages: [{ role: "user", content: "Hello" }],
});

코딩 에이전트 통합

코딩 에이전트는 이미 사용하고 있는 프로토콜 그대로 게이트웨이에 연결합니다. Claude 계열 에이전트는 /v1/messages, Codex는 /v1/responses, 그 외에는 /v1/chat/completions를 사용합니다. 도구가 ChinaAPI를 가리키도록 설정하면, 해당 요청도 여러분의 API 트래픽과 동일한 키·쿼터·로그·과금을 그대로 사용합니다.

Base URL 형태 Claude Code는 전달받은 값 뒤에 /v1/messages를 스스로 붙이므로, 호스트만 있는 https://api.chinaapi.ai를 사용합니다. 이 페이지의 다른 모든 도구는 /v1 접미사를 명시적으로 요구합니다. /v1이 중복되거나 빠지는 것이 여기서 404가 발생하는 가장 흔한 원인입니다.

Hermes Agent

POST /v1/chat/completions

~/.hermes/config.yaml의 model 블록을 게이트웨이로 향하게 하거나, hermes model을 실행해 대화형으로 Custom endpoint를 선택하세요. base_url에는 /v1 접미사까지 포함하며, /chat/completions는 Hermes가 자동으로 붙입니다.

yaml · ~/.hermes/config.yaml

model:
  default: kimi-k2.7-code
  provider: custom
  base_url: https://api.chinaapi.ai/v1
  api_key: <your ChinaAPI key>

Claude Code

POST /v1/messages

세 가지 환경 변수를 export한 뒤 평소처럼 claude를 실행하세요. ANTHROPIC_DEFAULT_*_MODEL 변수는 Claude Code 내부의 모델 등급을 ChinaAPI 모델에 매핑하며, 이를 통해 수정하지 않은 Claude Code에서도 중국 모델을 실행할 수 있습니다.

shell · Claude Code

export ANTHROPIC_BASE_URL=https://api.chinaapi.ai
export ANTHROPIC_AUTH_TOKEN=$CHINAAPI_KEY
export ANTHROPIC_DEFAULT_OPUS_MODEL=kimi-k3
export ANTHROPIC_DEFAULT_SONNET_MODEL=kimi-k2.7-code
export ANTHROPIC_DEFAULT_HAIKU_MODEL=glm-5-turbo

claude

Codex

POST /v1/responses

Codex는 Responses 프로토콜을 사용하므로 wire_api는 반드시 responses여야 합니다. chat 형식 그대로 두면 도구 호출이 깨집니다. 키는 env_key로 지정한 환경 변수에 넣으세요.

toml · ~/.codex/config.toml

model = "deepseek-v4-flash"
model_provider = "chinaapi"

[model_providers.chinaapi]
name = "ChinaAPI"
base_url = "https://api.chinaapi.ai/v1"
wire_api = "responses"
env_key = "CHINAAPI_KEY"

Cline, Roo Code, Kilo Code

POST /v1/chat/completions

세 도구 모두 동일한 OpenAI Compatible 제공업체 양식을 항목별로 그대로 사용합니다. 모델 ID는 콘솔 → 모델에 표시된 그대로 정확히 입력하세요. 이 도구들은 커스텀 제공업체의 모델 목록을 자동으로 가져오지 않습니다.

Settings → API Provider → OpenAI Compatible

Base URL   https://api.chinaapi.ai/v1
API Key    <your ChinaAPI key>
Model ID   glm-5.2

Cursor

POST /v1/chat/completions

Settings → Models → OpenAI API Key에서 base URL을 재정의하세요. 먼저 Add model로 ChinaAPI 모델 이름을 추가한 다음, ChinaAPI 모델만 활성화된 상태로 두세요. 그렇지 않으면 Cursor가 내장 모델 이름을 재정의한 URL로 그대로 전송합니다.

Settings → Models → Override Base URL

Base URL   https://api.chinaapi.ai/v1
API Key    <your ChinaAPI key>
Model      deepseek-v4-pro

OpenClaw

POST /v1/messages

"api": "anthropic-messages"로 ChinaAPI를 제공업체로 선언하고, 세션 선택기에 표시할 모델을 나열하세요.

json · ~/.openclaw/openclaw.json

{
  "models": {
    "providers": {
      "chinaapi": {
        "baseUrl": "https://api.chinaapi.ai",
        "apiKey": "<your ChinaAPI key>",
        "api": "anthropic-messages",
        "models": ["kimi-k3", "glm-5.2"]
      }
    }
  }
}

Aider

POST /v1/chat/completions

Aider는 모델 이름의 접두사로 라우팅하므로, 모델 자체가 중국 모델이더라도 openai/ 접두사는 그대로 유지하세요.

shell · Aider

export OPENAI_API_BASE=https://api.chinaapi.ai/v1
export OPENAI_API_KEY=$CHINAAPI_KEY

aider --model openai/deepseek-v4-pro

모델 선택: 위의 모델 이름은 동작 예시일 뿐 고정된 목록이 아닙니다. 계정에서 활성화된 별칭은 콘솔 → 모델에서 확인하세요. 에이전트 용도로는 가장 많이 쓰이는 등급에 코딩 특화 모델을, 가벼운 등급에는 저렴하고 빠른 모델을 배치하는 것이 좋습니다. 예를 들어 Claude Code는 백그라운드 요약을 Haiku 등급으로 보내므로, 이 등급을 작은 모델에 매핑하면 쿼터를 가장 많이 절약할 수 있습니다.

이미지·음성·동영상·검색 통합

이 기능들은 채팅과 동일한 Base URL과 bearer 키를 사용하지만, 각각 고유한 엔드포인트와 페이로드를 가집니다. 아래 모델 ID는 동작 예시이니, 배포 전에 콘솔 → 모델에서 최신 모델 카탈로그를 확인하세요.

이미지 생성

POST /v1/images/generations

JSON 프롬프트를 전송하세요. 생성된 결과는 data[0].url에서, 선택한 모델이 base64를 반환하는 경우에는 data[0].b64_json에서 읽습니다.

주요 파라미터: prompt와 model은 필수입니다. 해상도는 size, 이미지 개수는 n, 반환 형식은 response_format에 url 또는 b64_json을 사용하세요. quality와 style은 모델별로 다르며, 일반적인 값으로는 standard, hd, auto가 있습니다.

curl · image

curl https://api.chinaapi.ai/v1/images/generations \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedream-4-5-251128",
    "prompt": "A cinematic skyline at blue hour",
    "size": "1024x1024",
    "response_format": "url",
    "n": 1
  }'

Gemini 이미지 생성

POST /v1/chat/completions

Gemini 이미지 모델은 OpenAI Chat Completions 요청 형식을 사용합니다. 생성된 Markdown 이미지는 choices[0].message.content에서 읽으며, 이미지 페이로드는 data:image/... URL입니다.

주요 파라미터: 로그인 후 카탈로그의 모델 ID를 model에, 이미지 프롬프트를 messages에 담으세요. 이 모델을 /v1/images/generations로 보내지 마세요.

curl · Gemini image chat

curl https://api.chinaapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<GEMINI_IMAGE_MODEL>",
    "messages": [
      {
        "role": "user",
        "content": "Generate a cinematic skyline at blue hour"
      }
    ],
    "stream": false
  }'

음성 인식

POST /v1/audio/transcriptions

오디오를 multipart form data로 업로드하세요. Content-Type 헤더를 수동으로 설정하지 마세요. 인식된 텍스트는 text 필드로 반환됩니다.

주요 파라미터: model과 file을 multipart 필드로 전송하세요. 선택한 모델이 지원하는 경우 response_format에 json, text, verbose_json을 사용할 수 있습니다.

curl · transcription

curl https://api.chinaapi.ai/v1/audio/transcriptions \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -F "model=qwen3-asr-flash" \
  -F "file=@speech.wav" \
  -F "response_format=json"

음성 합성

POST /v1/audio/speech

응답 본문은 바이너리 오디오이므로 파일로 저장하세요. alloy는 모델의 기본 음성을 선택하며, 모델에 따라 제공업체 고유의 음성 ID도 제공할 수 있습니다.

주요 파라미터: input, model, voice를 사용하세요. response_format으로 mp3나 wav 등의 출력을 선택하며, 선택한 모델이 지원하는 경우 speed와 instructions를 사용할 수 있습니다.

curl · speech

curl https://api.chinaapi.ai/v1/audio/speech \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "mimo-v2.5-tts",
    "input": "Hello from ChinaAPI.",
    "voice": "alloy",
    "response_format": "mp3"
  }' \
  --output speech.mp3

동영상 생성

POST /v1/video/generations

동영상 생성은 비동기로 처리됩니다. 한 번만 요청을 보내 반환된 task_id를 저장한 뒤, 성공하거나 실패할 때까지 GET /v1/video/generations/{task_id}를 폴링하세요. 작업 생성은 쿼터를 소비할 수 있습니다.

주요 파라미터: prompt와 model로 작업을 시작합니다. 지원되는 경우 duration, width, height, fps, n을 사용하세요. 해상도는 일반적인 화질 제어 수단입니다. quality, quality_level, negative_prompt, 카메라 설정 등 제공업체 고유 옵션은 해당 모델에 명시된 경우에만 metadata에 넣으세요.

curl · video

curl https://api.chinaapi.ai/v1/video/generations \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "happyhorse-1.1-t2v",
    "prompt": "A paper boat crossing a moonlit lake",
    "duration": 5,
    "width": 1280,
    "height": 720
  }'

curl https://api.chinaapi.ai/v1/video/generations/$TASK_ID \
  -H "Authorization: Bearer $CHINAAPI_KEY"

임베딩

POST /v1/embeddings

하나의 문자열 또는 문자열 배열을 전송하세요. 벡터는 입력과 동일한 순서로 data[].embedding에 반환됩니다.

주요 파라미터: input은 문자열 하나 또는 배치를 받습니다. 선택한 임베딩 모델이 지원하는 경우에만 dimensions와 encoding_format을 사용하세요.

curl · embeddings

curl https://api.chinaapi.ai/v1/embeddings \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "text-embedding-v4",
    "input": ["ChinaAPI connects Chinese AI models."]
  }'

리랭크

POST /v1/rerank

쿼리에 대해 후보 문서의 순위를 매깁니다. 정렬된 결과와 관련도 점수는 results에서 확인하세요.

주요 파라미터: query와 documents를 전송하고, 반환되는 순위 후보 수를 제한하려면 top_n을 사용하세요.

curl · rerank

curl https://api.chinaapi.ai/v1/rerank \
  -H "Authorization: Bearer $CHINAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gte-rerank-v2",
    "query": "How do I call Chinese AI models?",
    "documents": [
      "Use one ChinaAPI Base URL and API key.",
      "Install a local database."
    ],
    "top_n": 2
  }'

대시보드에서 운영하기

ChinaAPI는 단순한 전달 엔드포인트가 아닙니다. 실제 프로덕션 트래픽을 위한 키, 사용자, 그룹, 채널 상태, 로그, 쿼터, 과금 제어 기능을 포함합니다.

키

범위가 지정된 API 토큰

토큰을 생성하고 교체하며, 그룹을 할당하고 사용자 트래픽을 격리하세요.

라우팅

제공업체 폴백

여러 업스트림 채널을 구성하면 제공업체 장애가 발생해도 하나의 모델 별칭이 계속 동작합니다.

로그

사용량 및 비용

요청 상태, 토큰 사용량, 쿼터 소비, 오류 세부 정보를 한곳에서 추적하세요.