API

OpenAI 호환. 모든 모델.

기존 OpenAI SDK를 https://api.yout.chat/v1 로 Yout.chat 키와 함께 연결하면 모든 주요 모델을 사용할 수 있습니다. 하나의 크레딧 풀, 하나의 청구서, 모델별 계약은 없습니다.

기본 URL: https://api.yout.chat/v1 · 인증: Authorization: Bearer <your-key>

그대로 대체 가능

코드가 이미 OpenAI API와 통신하고 있다면 두 가지만 바꾸면 됩니다.

from openai import OpenAI

client = OpenAI(
    api_key="yout-...",                  # ← from Account → API keys
    base_url="https://api.yout.chat/v1",       # ← that's it
)

resp = client.chat.completions.create(
    model="anthropic-claude-sonnet-46",
    messages=[
        {"role": "user", "content": "Write a haiku about caching."},
    ],
)
print(resp.choices[0].message.content)

다음과 변경 없이 작동합니다: OpenAI Python SDK, OpenAI Node SDK, LangChain, LlamaIndex, Vercel AI SDK, LiteLLM, 및 OpenAI 형식을 지원하는 그 밖의 모든 것.

엔드포인트

모든 엔드포인트는 다음을 허용합니다: Authorization: Bearer <key>. 세션 쿠키는 웹 앱에서 작동합니다.

POST/v1/chat/completions

OpenAI 호환. 다음을 전달하세요: stream: true SSE용. 크레딧은 원자적으로 차감됩니다.

요청 본문
{
  "model": "anthropic-claude-sonnet-46",
  "messages": [
    {"role": "system", "content": "You are helpful."},
    {"role": "user",   "content": "What is 2+2?"}
  ],
  "stream": false,
  "temperature": 0.7,
  "max_tokens": 512
}
응답 (비스트리밍)
{
  "id": "chatcmpl-...",
  "object": "chat.completion",
  "model": "anthropic-claude-sonnet-46",
  "choices": [{"index":0,"message":{"role":"assistant","content":"Four."},"finish_reason":"stop"}],
  "usage": {"prompt_tokens": 15, "completion_tokens": 2, "total_tokens": 17},
  "yout": {"credits_charged": 10, "balance": 14999990}
}
GET/v1/models

OpenAI 호환 모델 목록. 다음과 함께 활성화된 모든 모델: id, context_window, 및 토큰당 크레딧 비용.

POST/api/chat/stream/

네이티브 스트리밍 엔드포인트 — OpenAI보다 단순한 JSON 형식으로 웹 앱에서 사용합니다. 타사 SDK 호환성을 위해서는 /v1/chat/completions 를 사용하는 것이 좋습니다.

GET/api/chat/models/

작업 태그, 모달리티, Pro 전용 플래그가 포함된 더 풍부한 모델 카탈로그. 자체 UI에서 이를 사용하세요.

GET/api/chat/limit/

현재 할당량 — 크레딧 잔액 + 플랜 상태, 또는 익명 일일 허용량.

GET/api/chat/keys/

활성 API 키 목록 (마스킹됨).

POST/api/chat/keys/

이름이 지정된 API 키를 생성합니다. 전체 토큰은 한 번만 반환되니 저장하세요.

요청 본문
{"name": "production"}
POST/api/chat/keys/<id>/revoke/

키를 취소합니다. 이를 사용하는 기존 세션은 다음 호출 시 401 을(를) 받습니다.

POST/api/media/image/

이미지 생성 작업. 다음을 반환합니다: job_uuid; 폴링 /api/media/jobs/<uuid>/.

POST/api/media/video/

비디오 생성 작업. 5초 분량 Veo에 약 120만 크레딧. 실패 시 크레딧이 자동 환불됩니다.

POST/api/media/speech/

텍스트 음성 변환. 다음을 반환합니다: job_uuid; 출력은 완료되면 서명된 오디오 URL입니다.

GET/api/media/jobs/<uuid>/

생성 작업 폴링: status, output_url, error, credits_cost.

POST/api/chat/share/

공개 읽기 전용 스냅샷을 생성합니다. 다음 URL을 반환합니다: /c/<slug> URL.

POST/api/chat/purge/

대화, 메시지, 사용 원장을 서버 측에서 삭제합니다.

청구

API 사용량은 웹 앱과 동일한 크레딧 풀에서 차감됩니다. 별도의 API 청구는 없습니다.

토큰당 가격

텍스트 모델은 다음을 청구합니다: credits_per_1k_input × 입력 토큰 + credits_per_1k_output × 출력 토큰. 미디어 모델은 정액으로 청구됩니다: credits_per_call.

최소 청구

성공한 모든 호출은 토큰 수에 관계없이 오버헤드를 충당하기 위해 최소 10크레딧을 차감합니다.

실패 환불

업스트림에서 실패한 이미지/비디오/음성 작업은 크레딧을 자동으로 환불합니다. 텍스트 스트림 실패는 생성된 부분만 청구합니다.

초과 인출

잔액이 예상 비용을 감당할 수 없을 때 호출은 402 insufficient_credits 을(를) 반환합니다. 다음이 참이고 잔액이 양수인 한 플랜은 제한되지 않습니다: plan_active 잔액이 양수인 경우.

인증 & 개인정보 보호

  • Bearer 토큰 — 사용자별로 계정 페이지에서 확인할 수 있습니다. 계정을 삭제 후 재생성하여 교체하세요 (적절한 교체 엔드포인트는 로드맵에 있습니다).
  • 사용자 식별 정보를 전달하지 않음 — 이메일, IP, 사용자 에이전트 또는 계정 ID 없이 공급자에 프록시합니다. 일반적인 HTTP-Referer: yout.chat 만 사용합니다.
  • no-log 신호 — 을(를) 업스트림으로 전송하여 모델 공급자의 계약이 허용하는 경우 귀하의 프롬프트를 기록하거나 학습에 사용하지 않도록 요청합니다.
  • 기본적으로 메시지 내용을 저장하지 않음 — 다음 행을 기록합니다: UsageLedger 행(토큰 + 크레딧 + 모델)을 기록하지만 프롬프트나 응답은 기록하지 않습니다.

로드맵

  • OpenAI 호환 /v1/chat/completions 심(shim)으로 기존 SDK가 변경 없이 작동
  • 장시간 실행되는 미디어 작업을 위한 웹훅 콜백 (폴링 대체)
  • 토큰 교체 + 토큰별 범위
  • 다음에 대한 멱등성 키: /stream/ + 재시도 안전 작업 생성
  • 셀프서비스 속도 제한 제어

출시할 준비가 되셨나요?

무료 등급에서 사용해 볼 수 있는 50K 크레딧을 제공합니다. 더 필요하면 업그레이드하세요.