자주 묻는 질문
짧은 답변이며 각각 그 자체로 완결됩니다. model에 넣을 정확한 이름은 모델 페이지에서, 현재 가격은 oceantoken.ai의 각 모델 페이지에서 확인하세요.
OceanToken은 무엇인가요?
OceanToken은 500개 이상의 AI 모델을 하나의 API와 하나의 선불 잔액으로 쓰는 서비스입니다. OpenAI, Anthropic, Google, DeepSeek, Qwen, ByteDance를 비롯해 약 60곳의 다른 게시자가 만든 텍스트, 이미지, 동영상, 음성 합성, 전사, 임베딩, 리랭크 모델이 포함됩니다. 계정을 하나 만들고 크레딧을 충전한 뒤 API 키를 만들면, 같은 Base URL과 같은 키로 어떤 모델이든 호출할 수 있습니다. 모든 모델의 가격, 컨텍스트 윈도우, 기능은 호출하기 전에 카탈로그에서 확인할 수 있습니다.
OceanToken은 OpenAI와 호환되나요? 어떤 SDK를 쓸 수 있나요?
네. OceanToken API는 OpenAI API와 같은 형식이므로, Python, TypeScript 등의 공식 OpenAI SDK는 두 값만 바꾸면 동작합니다. Base URL을 https://api.oceantoken.ai/v1로, API 키를 OceanToken 키로 바꾸세요. Claude, GPT, Gemini, DeepSeek를 포함한 모든 채팅 모델은 /v1/messages에서 Anthropic Messages API로도 응답하므로, Anthropic SDK도 같은 두 가지만 바꾸면 그대로 쓸 수 있습니다. Anthropic SDK에는 Base URL로 https://api.oceantoken.ai를 지정하며, /v1은 SDK가 직접 붙입니다. Chat Completions, Responses API, 이미지, 동영상, 임베딩, 음성 합성, 전사, 리랭크 모두 같은 형식을 따릅니다.
OceanToken으로 어떤 AI 모델을 호출할 수 있나요?
카탈로그에는 7가지 유형에 걸쳐 500개 이상의 모델이 있습니다. 언어 모델(GPT, Claude, Gemini, DeepSeek, Qwen, GLM, Kimi, Grok, Mistral, Llama 등), 이미지 생성·편집 모델, 동영상 생성 모델, 텍스트 음성 변환, 음성 텍스트 변환, 텍스트 임베딩, 리랭커입니다. 모델 페이지에는 모든 모델의 정확한 모델 ID, 단가, 컨텍스트 윈도우, 그리고 추론·도구 호출·이미지 입력 지원 여부가 나와 있습니다. 이 목록은 문서를 게시할 때마다 운영 중인 서비스에서 새로 만들어집니다.
OceanToken은 얼마인가요? 플랫폼 수수료가 있나요?
모델마다 표시된 가격으로 사용한 만큼 미국 달러로 선불 잔액에서 지불합니다. 구독은 없습니다. 모델은 사용량에 따라 과금되며 플랫폼 수수료는 없습니다. 충전할 때는 결제 총액의 2.9% + $0.30의 결제 수수료가 결제에 추가되며(모든 결제 수단 동일), 잔액에는 포함되지 않습니다. 예를 들어 $100어치 크레딧은 $103.30입니다. 언어 모델은 입력, 캐시 입력, 출력 토큰 100만 개당(캐시 쓰기에 과금하는 모델은 그것도) 가격이 매겨지고, 이미지는 장당·메가픽셀당·이미지 토큰당, 동영상은 초당, 음성 합성은 1,000자당, 전사는 오디오 분당, Cohere 리랭크는 검색 단위당 가격입니다. 모델 가격은 하루 중 어느 시간에도 같으며, smart-router는 선택한 모델의 가격으로 과금됩니다. :free 태그가 붙은 일부 모델은 무료이며 처리량이 제한됩니다. 호출하기 전에 oceantoken.ai의 각 모델 페이지에서 현재 가격을 확인할 수 있습니다.
Claude 프롬프트가 캐시되지 않는 이유는 무엇인가요?
Claude는 요청에서 요구할 때만 프롬프트를 캐시합니다. /v1/chat/completions 또는 /v1/messages에서 반복되는 부분의 끝에 있는 콘텐츠 블록에 "cache_control": {"type": "ephemeral"}을 붙이세요. 다음 요청부터 그 부분은 캐시에서 읽히고 모델의 캐시 입력 가격으로 과금됩니다. GPT, DeepSeek, Qwen, GLM 모델은 스스로 캐시합니다. 캐시 적중은 usage에 표시됩니다. Chat Completions에서는 prompt_tokens_details.cached_tokens, /v1/messages에서는 cache_read_input_tokens입니다. Claude는 최소 길이를 넘는 접두부만 캐시하며, 모델에 따라 512~4,096토큰입니다. 두 형식의 예시는 API 레퍼런스에 있습니다.
Claude Code, Codex, Cursor, Gemini CLI에서 OceanToken을 쓰려면 어떻게 하나요?
터미널에서 명령 하나를 실행하고 로그인하세요: npx -y @oceantoken/cli@latest connect codex (또는 claude-code, cursor, gemini, openclaw). 그러면 해당 에이전트에 OceanToken MCP 서버(https://mcp.oceantoken.ai/mcp)와 스킬 3개가 추가되어, 에이전트가 모델을 검색하고 비용을 추정하며 잔액으로 이미지, 동영상, 음성을 생성할 수 있습니다. AI 에이전트가 https://mcp.oceantoken.ai/install의 안내를 직접 따라 설치할 수도 있습니다. 같은 API 키는 Base URL만 설정하면 OpenAI와 호환되는 어떤 도구에서도 쓸 수 있습니다.
OceanToken은 텍스트뿐 아니라 이미지, 동영상, 음성도 생성하나요?
네. 이미지 모델은 /v1/images/generations와 /v1/images/edits, 동영상 모델은 /v1/videos(폴링하는 비동기 작업), 텍스트 음성 변환은 /v1/audio/speech, 전사는 /v1/audio/transcriptions, 임베딩은 /v1/embeddings, 리랭커는 /v1/rerank에서 응답합니다. 7가지 유형 모두 같은 키와 잔액을 쓰며, 각 요청은 비용과 지연 시간과 함께 콘솔의 로그에 표시됩니다. 이미지와 동영상 다운로드 URL은 24시간 유효하고, 동영상 작업은 Idempotency-Key를 받으므로 재시도로 두 번째 작업이 시작되어 과금되는 일은 없습니다.
API 키별로 쓸 수 있는 금액을 제한할 수 있나요?
네. API 키마다 자체 크레딧 한도(일·주·월 단위 초기화 선택 가능)와 만료일을 설정할 수 있어, 테스트 프로젝트나 팀원용 키가 공유 잔액에서 허용한 금액 이상을 쓰지 못합니다. 한도를 다 쓴 키는 계정에 크레딧이 남아 있어도 400 key_budget_exceeded 오류를 받습니다. 콘솔에서 키별 사용량을 볼 수 있고, 로그 페이지에는 각 요청의 모델, 토큰, 비용, 지연 시간이 나옵니다. 키는 만들 때 한 번만 표시되며, 24시간 겹치는 기간을 두고 교체할 수 있습니다.
결제와 선불 잔액은 어떻게 작동하나요?
콘솔에서 카드로 크레딧을 충전합니다($5, $10, $25, $50 중에서 고르거나 원하는 금액을 입력). 충전할 때는 결제 총액의 2.9% + $0.30의 결제 수수료가 결제에 추가되며(모든 결제 수단 동일), 잔액에는 포함되지 않습니다. 첫 충전에는 구매한 크레딧의 10%(최대 $100)가 보너스로 지급됩니다(규칙은 '첫 충전 보너스' 참고: https://docs.oceantoken.ai/ko/get-started/add-credits#first-top-up-bonus ). 각 요청은 호출 시점에 해당 모델에 표시된 가격으로 선불 잔액에서 정확한 비용이 차감되며, 소급해서 바뀌지 않습니다. 구매한 크레딧은 구매일로부터 12개월간 유효하고(서비스 약관 제6조), 월 최소 사용액은 없습니다. 잔액이 $0 이하인 동안에는 크레딧을 충전할 때까지 유료 모델에 대한 모든 요청이 거부됩니다(모델 ID가 :free로 끝나는 모델은 계속 사용할 수 있습니다). 동영상 같은 긴 작업은 끝날 때까지 예상 비용을 잡아 둡니다. 지출은 활동 페이지에서 일별·모델별로 볼 수 있습니다.
OceanToken에 무료 요금제가 있나요?
모델 ID가 :free로 끝나는 모델은 무료로 호출할 수 있으며, 처리량은 제한되고 보장되지 않습니다. 모델 페이지의 필터에서는 Free 라벨로 표시됩니다. 잔액이 $0인 경우에도 호출할 수 있고 호출해도 잔액이 줄지 않으므로, 비용 없이 API 형식, SDK 설정, 에이전트 연동을 테스트하고 모델 ID만 바꿔 유료 모델로 전환할 수 있습니다.
OceanToken의 속도 제한과 타임아웃은 어떻게 되나요?
속도 제한은 API 키별로 분당 요청 수와 분당 토큰 수로 적용되며, 응답의 x-oceantoken-key-rpm-limit 및 x-oceantoken-key-tpm-limit 헤더에 키의 한도가 담깁니다. 한도를 넘으면 Retry-After 헤더와 함께 429 rate_limited가 반환됩니다. 동기 요청은 최대 240초 동안 실행되고 요청 본문은 최대 10 MB이므로, 긴 텍스트 생성에는 stream: true를 쓰고 큰 파일은 URL로 보내세요. 동영상 생성은 몇 분이 걸리는 작업으로 실행되므로, 연결을 열어 두는 대신 /v1/videos/{video_id}를 폴링합니다. 자세한 내용은 제한 페이지에 있습니다.
모델 제공업체에 장애가 나면 어떻게 되나요?
대개는 아무것도 느끼지 못합니다. 현재의 Claude와 GPT 모델을 포함한 많은 모델에는 공식 또는 승인된 채널이 두 개 이상 있습니다. 한 채널이 실패하거나 용량이 꽉 차거나 응답이 없으면, OceanToken은 요청을 재시도하고 같은 가격으로 같은 모델의 다른 채널로 옮깁니다. fallbacks 매개변수로 직접 예비 모델을 지정하지 않는 한 다른 모델로 답하지 않으며, 출력을 만들기 전에 실패한 시도는 과금되지 않습니다. 잘못된 형식의 요청이나 안전성 거부처럼 어느 채널이든 반환할 오류는 그대로 전달되며, 출력이 시작된 뒤 끊긴 스트림은 오류로 끝날 수 있으므로 429와 5xx에는 백오프를 둔 재시도를 준비하세요. 자세한 내용은 재시도와 장애 조치 페이지에 있습니다.