메인 콘텐츠로 건너뛰기
엔드포인트: POST /chat/completions 대부분의 모델 API 연동은 이 인터페이스를 사용해야 합니다. 요청 본문에 model과 messages가 포함되면 YouRouter는 OpenAI 호환 completion 응답을 반환합니다. 시각 기능을 지원하는 모델의 경우 messages[].content에 이미지 입력을 포함할 수 있습니다.

​
요청

curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: connected"
      }
    ]
  }'

​
OpenAI SDK

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["YOUROUTER_API_KEY"],
    base_url="https://api.yourouter.ai/v1",
)

completion = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Reply with exactly: connected"}],
)

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

​
요청 헤더

헤더필수설명
Authorization예Bearer <YOUR_YOUROUTER_API_KEY>
Content-Type예application/json을 사용합니다.
vendor아니오auto 사용 또는 생략 시 자동 라우팅. openai, anthropic, google 등으로 상위를 고정할 수 있습니다.

​
요청 본문 매개변수

​
model
string
필수
호출할 모델 ID(예: gpt-4o, claude-sonnet-4-20250514, gemini-2.5-flash).
​
messages
array
필수
순서가 있는 대화 메시지 배열. 각 메시지는 role과 content를 포함합니다.
​
stream
boolean
기본값:"false"
true이면 SSE 조각으로 결과를 반환합니다.
​
temperature
number
모델이 지원할 때 출력 무작위성을 조절합니다.
​
max_tokens
integer
모델이 지원할 때 출력 토큰 수를 제한합니다.
​
tools
array
함수 호출 또는 도구 호출을 지원하는 모델에 도구 정의를 전달합니다.

​
멀티모달 이미지 입력

시각을 지원하는 모델의 경우 content를 블록 배열로 설정하고 최소 하나의 text 블록과 하나의 image_url 블록을 포함하세요. 
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "type": "text",
            "text": "Describe this image in one sentence."
          },
          {
            "type": "image_url",
            "image_url": {
              "url": "https://example.com/image.jpg"
            }
          }
        ]
      }
    ]
  }'
비공개 이미지에는 base64 data URL을 사용할 수 있습니다. 
{
  "type": "image_url",
  "image_url": {
    "url": "data:image/jpeg;base64,<BASE64_IMAGE>"
  }
}
Gemini 네이티브 및 Claude 네이티브 형식 예시는 멀티모달 가이드를 참고하세요.

​
응답

성공 응답은 OpenAI Chat Completions 구조를 따릅니다. 
{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "connected"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 1,
    "total_tokens": 13
  }
}
어시스턴트 텍스트는 보통 다음 위치에 있습니다. 
choices[0].message.content

​
제공업체 라우팅

기본적으로 자동 라우팅입니다. 
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello"}]}'
제공업체를 고정하려면 vendor를 보냅니다. 
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "vendor: openai" \
  -d '{"model": "gpt-4o", "messages": [{"role": "user", "content": "Hello"}]}'

​
스트리밍

stream을 true로 설정하면 SSE로 증분 결과를 반환합니다. 
curl https://api.yourouter.ai/v1/chat/completions \
  -H "Authorization: Bearer $YOUROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "stream": true,
    "messages": [
      {
        "role": "user",
        "content": "Explain model routing in two sentences."
      }
    ]
  }'

​
일반적인 오류

상태 코드원인확인 사항
400본문이 잘못되었거나 지원하지 않는 매개변수model, messages, JSON 형식을 확인하세요.
401API 키가 없거나 잘못됨Authorization 헤드를 확인하세요.
429제공업체 속도 제한 또는 동시성 제한백오프로 재시도하거나 자동 라우팅으로 전환하세요.
500게이트웨이 또는 상위 제공업체 오류안전하게 재시도하고 지원을 위해 요청 ID를 보관하세요.
모델 ID와 제공업체 고정에 대한 더 많은 예시는 모델과 라우팅 가이드를 참고하세요.