API 문서

Base URL

OpenAI SDK·Cursor·opencode 등에 base URL 을 입력할 때는 반드시 /v1 까지 포함하세요. 클라이언트가 /chat/completions 등 경로를 뒤에 붙입니다./v1/chat/completions 는 stream: true 시 토큰 단위 실시간 SSE 스트리밍을 지원합니다 (최대 5분). 비스트리밍 요청은 30초 한도가 적용되므로 긴 응답이 예상되면 stream: true 를 사용하세요.

인증

모든 요청에 API 키를 헤더로 전달하세요:

Authorization: Bearer everyais_your_api_key

퀵스타트

curl:

curl https://api.everyais.com/v1/chat/completions \
  -H "Authorization: Bearer everyais_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "everyais/claude-sonnet-4-6",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Python (openai SDK):

from openai import OpenAI

client = OpenAI(
    base_url="https://api.everyais.com/v1",
    api_key="everyais_your_api_key",
)
resp = client.chat.completions.create(
    model="everyais/claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)

Node.js (openai SDK):

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.everyais.com/v1",
  apiKey: "everyais_your_api_key",
});
const resp = await client.chat.completions.create({
  model: "everyais/claude-sonnet-4-6",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(resp.choices[0].message.content);

코딩 도구 연동 (Cursor / opencode / Continue / Claude Code)

// opencode.json
{
  "provider": {
    "everyais": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.everyais.com/v1",
        "apiKey": "{env:EVERYAIS_API_KEY}"
      },
      "models": {
        "everyais/claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" },
        "everyais/g/gemini-3-pro-preview": { "name": "Gemini 3 Pro" }
      }
    }
  }
}

에러 형식 & 레이트리밋

모든 에러는 OpenAI 호환 envelope 으로 반환됩니다:

{
  "error": {
    "message": "Incorrect API key provided. ...",
    "type": "authentication_error",
    "param": null,
    "code": "invalid_api_key"
  }
}

기본 레이트리밋은 키당 100 req/min 이며 키 생성 시 조정할 수 있습니다. 응답의 X-RateLimit-Limit / X-RateLimit-Remaining / X-RateLimit-Reset 헤더로 잔여량을 확인하세요.

호환 편의 기능

• 모델명 prefix 생략 — everyais/ 없이도 호출됩니다.claude-sonnet-4-6 는 everyais/claude-sonnet-4-6 로, 프로바이더 native 모델 ID 도 자동 매핑됩니다.
• 호출당 비용 헤더 — 비스트림 응답에 x-everyais-cost-usd 헤더로 해당 요청의 서비스 가격(USD)이 포함됩니다. 에이전트 예산 가드에 사용하세요.
• Idempotency-Key — POST 요청에 Idempotency-Key 헤더를 보내면 재시도 시 중복 호출·중복 과금을 방지합니다(24h, 비스트림 한정). 재생된 응답에는 Idempotent-Replayed: true 헤더가 붙습니다.
• usage 세부 토큰 — 프로바이더가 제공할 경우 usage.prompt_tokens_details.cached_tokens (캐시 적중) 및 cache_creation_tokens (캐시 생성) 가 포함됩니다.
• Prompt caching — Claude 계열 모델은 prompt caching 을 지원합니다. Anthropic /v1/messages 의 cache_control breakpoint 는 그대로 전달되며, 별도 설정 없이도 게이트웨이가 시스템·도구·직전 메시지에 자동으로 캐시 breakpoint 를 부착해 반복 컨텍스트 비용을 절감합니다. 캐시 read/write 토큰은 공급자 단가에 맞춰 분해 청구됩니다.
• per-key 예산 · 스코프 — 대시보드에서 API 키별 월/일 지출 한도(USD)와 허용 엔드포인트 스코프(chat·images·video·models:read)를 설정할 수 있습니다. 한도 초과 시 402, 스코프 밖 호출 시 403 을 반환합니다. (스코프를 모두 비우면 전체 허용)
• 긴 응답 — /v1/chat/completions·/v1/messages 스트리밍과 /v1/responses 는 최대 5분까지 처리됩니다. 그 외 비스트리밍 요청은 30초 한도이므로 긴 생성은 stream: true 를 사용하세요.
• 제약 — n 은 1 만 지원합니다(2 이상은 400). /v1/moderations 는 미지원(501)입니다.

모델 카탈로그

전체 목록은 GET /v1/models 로도 조회할 수 있습니다 (인증 필요). 단가 전체는 가격 페이지에서 확인하세요.