API 문서

OpenAI 호환 API 엔드포인트

Base URL

https://api.everyais.com/v1

OpenAI SDK·Cursor·opencode 등에 base URL 을 입력할 때는 반드시 /v1 까지 포함하세요. 클라이언트가 /chat/completions 등 경로를 뒤에 붙입니다./v1/chat/completionsstream: 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)

Cursor

  1. Settings → Models → API Keys 에서 OpenAI API Key 에 everyais 키 입력
  2. Override OpenAI Base URL 활성화 후 https://api.everyais.com/v1 입력
  3. 모델 목록에 everyais/claude-sonnet-4-6 등 모델 ID 를 직접 추가하고 Verify

참고: Cursor 커스텀 키는 채팅 모델에만 적용됩니다 (Tab 자동완성은 Cursor 자체 모델 사용).

opencode

// 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" }
      }
    }
  }
}

Continue / Cline / 기타 OpenAI 호환 도구

provider 를 openai 로 두고 base URL 에 https://api.everyais.com/v1, API key 에 everyais 키, model 에 아래 카탈로그의 모델 ID 를 입력하면 됩니다.

POST/v1/chat/completions채팅 완성
{
  "model": "everyais/claude-sonnet-4-6",
  "messages": [{"role": "user", "content": "Hello!"}],
  "stream": false
}
POST/v1/images/generations이미지 생성
{
  "model": "everyais/g/imagen-4",
  "prompt": "a beautiful sunset",
  "n": 1
}
POST/v1/videos/generations비디오 생성 (초당 과금, async operation — 응답의 id 로 /v1/outputs/{requestId} 폴링)
{
  "model": "everyais/g/veo-3-1-generate-001",
  "prompt": "a timelapse of a blooming flower",
  "duration": 8,
  "pricingVariant": "with-audio"
}
GET/v1/models사용 가능한 모델 목록
GET/v1/outputs/{requestId}출력 조회 (24h presigned URL)

에러 형식 & 레이트리밋

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

{
  "error": {
    "message": "Incorrect API key provided. ...",
    "type": "authentication_error",
    "param": null,
    "code": "invalid_api_key"
  }
}
상태type / code의미
400invalid_request_error잘못된 파라미터 / 컨텍스트 초과 (재시도 금지)
401authentication_error / invalid_api_key키 누락·오류·만료
402insufficient_quota_error / insufficient_quota크레딧 부족 또는 지출 한도 도달
403permission_error / model_not_allowed키의 허용 모델 제한
404invalid_request_error / model_not_found존재하지 않는 모델
429rate_limit_error / rate_limit_exceeded레이트리밋 — Retry-After 헤더 후 재시도
502api_error / upstream_error업스트림 프로바이더 장애 (재시도 가능)

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

모델 카탈로그

전체 목록은 GET /v1/models 로도 조회할 수 있습니다 (인증 필요).

모델 ID타입컨텍스트
everyais/claude-sonnet-4-6chat200,000
everyais/claude-haiku-4-5chat200,000
everyais/claude-opus-4-6chat200,000
everyais/claude-opus-4-7chat200,000
everyais/deepseek-v3-2chat163,000
everyais/minimax-m2-5chat196,608
everyais/glm-5chat202,752
everyais/g/gemini-2-5-pro-ttsaudio8,192
everyais/g/gemini-2-5-flash-ttsaudio8,192
everyais/g/gemini-live-2-5-flash-native-audiochat8,192
everyais/g/gemini-3-flash-previewchat8,192
everyais/g/gemini-3-1-flash-lite-previewchat8,192
everyais/g/imagen-4-fastimage8,192
everyais/g/imagen-4image8,192
everyais/g/imagen-4-ultraimage8,192
everyais/n/qwen3-embedding-8bembedding40,960
everyais/n/gpt-oss-120b-fastchat8,000
everyais/n/minimax-m2-5-fastchat8,000
everyais/n/qwen3-5-397b-a17b-fastchat8,000
everyais/n/kimi-k2-5-fastchat8,000
everyais/n/qwen3-5-397b-a17bchat262,144
everyais/qwen3-coder-nextchat8,192
everyais/mistral-large-3chat128,000
everyais/a/qwen3-235b-a22b-2507chat8,192
everyais/a/qwen3-coder-480b-a35b-instructchat8,192
everyais/a/deepseek-v3-1chat8,192
everyais/a/mistral-large-24-07chat8,192
everyais/g/gemmachat8,192
everyais/g/imagen-3-0-generate-002image8,192
everyais/g/imagen-4-0-generate-001image8,192
everyais/g/imagen-4-0-fast-generate-001image8,192
everyais/g/imagen-4-0-ultra-generate-001image8,192
everyais/g/imagen-3-0-capability-001image8,192
everyais/g/imagen-3-0-capability-002image8,192
everyais/g/veo-2-0-generate-001video8,192
everyais/g/veo-3-0-generate-001video8,192
everyais/g/veo-3-0-fast-generate-001video8,192
everyais/g/gemini-2-5-flash-preview-09-2025chat8,192
everyais/g/gemini-2-5-flash-lite-preview-09-2025chat8,192
everyais/g/gemini-2-5-flash-imageimage8,192
everyais/g/gemini-3-pro-previewchat8,192
everyais/g/gemini-3-pro-image-previewimage8,192
everyais/g/veo-3-1-generate-001video8,192
everyais/g/veo-3-1-fast-generate-001video8,192
everyais/g/veo-3-1-lite-generate-001video8,192
everyais/g/gemma-4-26b-a4b-it-maaschat8,192
everyais/m/llama3chat8,192
everyais/m/llama3-3chat8,192
everyais/m/llama-4-maverick-17b-128e-instruct-maaschat8,192
everyais/m/qwen3chat8,192
everyais/m/qwen3-coderchat8,192
everyais/m/qwen3-235b-a22b-instruct-2507-maaschat8,192
everyais/m/qwen3-coder-480b-a35b-instruct-maaschat8,192
everyais/m/qwen3-next-80b-a3b-instruct-maaschat8,192
everyais/m/qwen3-next-80b-a3b-thinking-maaschat8,192
everyais/m/qwen3-nextchat8,192
everyais/n/nemotron-3-nano-omnichat65,536
everyais/g/gemini-3-1-flash-litechat8,192
everyais/n/deepseek-v4-prochat1,048,576
everyais/n/glm-5-1chat202,752
everyais/g/gemini-3-5-flashchat8,192
everyais/n/kimi-k2-6chat262,144
everyais/claude-opus-4-8chat8,192
everyais/g/gemini-3-pro-imageimage8,192
google/tts-neural2audio8,192
google/stt-standardaudio8,192