/v1/chat/completions
OpenAI SDK, Cherry Studio, Cline, Open WebUI 등 대부분의 도구 클라이언트에서 사용할 수 있습니다.
요청 형식
/
일치하는 항목이 없습니다. 프로토콜, 기능 또는 엔드포인트 경로로 검색해 보세요.
세 가지 요청 형식이 카탈로그 전체를 포괄합니다. ChinaAPI 키 하나와 Base URL 하나로 모두 사용할 수 있으니, 클라이언트가 이미 쓰는 형식으로 보내세요.
/v1/messages
동일한 게이트웨이 키와 쿼터 제어를 유지한 채 Claude 형식의 메시지 페이로드를 라우팅합니다.
/v1/responses
Codex 등 Responses API 기반 클라이언트에서 사용합니다. 어떤 모델이 이 엔드포인트를 받는지는 콘솔에 표시됩니다.
Gemini 모델 전용
네이티브 Gemini 요청은
POST /v1beta/models/{model}:generateContent로 보냅니다. 이를 제공하는 것은 gemini-* 모델뿐이며, 그마저도 전부는 아닙니다 — 각 모델이 받는 형식은 Models의 해당 모델 항목에 표시됩니다. 나머지는 모두 위의 세 가지 형식 중 하나를 사용합니다.
타임아웃과 과금
과금은 클라이언트에 도달한 출력에 대해서만 이루어집니다. 비스트리밍 응답이 반환되기 전에 클라이언트가 연결을 끊거나 타임아웃되면 해당 요청은 과금되지 않습니다. 스트리밍 요청은 입력과 스트림이 끝날 때까지 전달된 출력에 대해 과금되며, 전달된 출력이 없으면 과금되지 않습니다. 아무것도 전달되기 전에 시간 예산을 모두 쓴 요청은
504 오류로 끝나며 과금되지 않습니다. 클라이언트가 얼마나 기다리는지 알려 주려면 X-Request-Timeout 헤더를 초 단위로 보내세요. OpenAI와 Anthropic 공식 SDK는 이미 자체 타임아웃을 보냅니다.
여러 턴으로 이어지는 Responses 대화는 previous_response_id로 이전 응답을 참조합니다. 후속 요청이 previous_response_not_found를 반환해도 이전 응답이 사라진 것은 아닙니다. 대화를 처음부터 다시 만들지 말고 10~20초 기다린 뒤 같은 요청을 다시 보내세요.