콘텐츠로 이동

첫 번째 호출

편집기를 연결하기 전에, 단일 요청으로 키가 작동하는지 확인하는 것이 좋습니다. Claudin.io는 OpenAI Chat Completions 형식(및 Anthropic Messages 형식도)을 지원합니다.

이 예제들은 $CLAUDINIO_API_KEY에서 키를 읽습니다 — 키 내보내기를 통해 한 번 설정하세요. (SDK 스니펫에서는 YOUR_API_KEY대시보드의 키로 바꾸거나, 같은 환경 변수에서 읽어오세요.)

cURL 사용하기

curl https://api.claudin.io/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLAUDINIO_API_KEY" \
  -d '{
    "model": "claudinio",
    "messages": [
      {"role": "user", "content": "Say hello in one short sentence."}
    ]
  }'

정상적인 OpenAI 스타일 JSON 응답과 choices 배열을 받게 됩니다.

x-api-key도 작동합니다

Claudin.io는 키를 Authorization: Bearer YOUR_API_KEY 또는 x-api-key: YOUR_API_KEY 헤더로 받습니다. 클라이언트가 보내는 방식을 사용하세요.

OpenAI Python SDK 사용하기

from openai import OpenAI

client = OpenAI(
    base_url="https://api.claudin.io/v1",
    api_key="YOUR_API_KEY",
)

resp = client.chat.completions.create(
    model="claudinio",
    messages=[{"role": "user", "content": "Say hello in one short sentence."}],
)

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

OpenAI Node SDK 사용하기

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.claudin.io/v1",
  apiKey: "YOUR_API_KEY",
});

const resp = await client.chat.completions.create({
  model: "claudinio",
  messages: [{ role: "user", content: "Say hello in one short sentence." }],
});

console.log(resp.choices[0].message.content);

스트리밍

stream: true로 설정하고 서버 전송 이벤트를 읽습니다. OpenAI API와 동일합니다:

curl https://api.claudin.io/v1/chat/completions \
  -H "Authorization: Bearer $CLAUDINIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claudinio",
    "stream": true,
    "messages": [{"role": "user", "content": "Count to five."}]
  }'

유효한 응답을 받았나요? 좋습니다 — 이제 자주 사용하는 도구 연결로 넘어가세요. 실패했다면 API 참조에서 일반적인 오류를 확인하세요.