본문으로 건너뛰기

빠른 시작

아무것도 없는 상태에서 모델의 답을 받기까지 세 단계입니다. Base URL: https://api.oceantoken.ai/v1.

Claude Code를 쓰시나요?

Claude Code에 이 두 명령을 입력해 OceanToken 플러그인을 설치한 다음 /mcp를 실행해 로그인합니다. 자세히.

/plugin marketplace add OceanTokenAI/oceantoken-plugins
/plugin install oceantoken@oceantoken

1. API 키 받기​

가입한 뒤 콘솔에서 API Keys를 열고 Create key를 선택합니다. 키가 표시되면 바로 복사하세요. sk-로 시작하며 한 번만 표시됩니다.

모든 새 계정에는 가입 시 14일간 유효한 $1 스타터 크레딧이 제공되며 카드 등록이 필요 없으므로, 첫 요청을 바로 실행할 수 있습니다. 모델 ID가 :free로 끝나는 모델은 잔액이 $0인 경우에도 호출할 수 있습니다. 유료 모델은 $0보다 큰 잔액이 필요하며, 더 사용하고 싶을 때 크레딧을 충전하면 됩니다. 단계별 자세한 내용은 각 페이지에 있습니다: 계정 만들기, API 키 만들기.

2. 셸에 키 설정하기​

export OCEANTOKEN_API_KEY=sk-...

예제는 이 환경 변수에서 키를 읽으므로 키가 코드에 남지 않습니다. Windows PowerShell에서는 $env:OCEANTOKEN_API_KEY = "sk-...".

3. 요청 보내기​

# Chat completion with curl. Any OpenAI-compatible client works the same way:
# point it at the base URL and use your OceanToken key.
curl -sS "${OCEANTOKEN_BASE_URL:-https://api.oceantoken.ai/v1}/chat/completions" \
  -H "Authorization: Bearer $OCEANTOKEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek/deepseek-v4.1-flash-1017",
    "messages": [{"role": "user", "content": "Say hello in one short sentence."}]
  }'

표준 chat completion 객체가 돌아옵니다. 답은 choices[0].message.content에, 과금 기준인 토큰 수는 usage에 있습니다. 요청은 콘솔의 Logs에 비용과 함께 표시됩니다.

연동에 필요한 것은 이것뿐입니다. API가 OpenAI와 호환되므로 어떤 OpenAI SDK나 도구든 Base URL과 키만 넣으면 동작하며, model 값은 모델 페이지에 있는 이름입니다. Claude를 포함한 모든 채팅 모델은 Anthropic Messages API로도 응답합니다. Anthropic SDK는 /v1을 스스로 붙이므로 https://api.oceantoken.ai를 넣습니다(아래).

이 페이지의 모든 예제는 게시 전에 서비스에 실제로 실행해 보는 파일입니다. OCEANTOKEN_API_KEY를 설정하면 그대로 실행됩니다.

답 스트리밍하기​

사람이 결과를 기다리는 경우에는 스트리밍을 쓰세요. 토큰이 생성되는 대로 도착하고, 긴 답도 제한에 설명된 요청 시간 초과에 걸리지 않습니다.

# Streaming: tokens arrive as they are generated. Use this for anything a person
# is waiting on, and for long answers, which would otherwise hit the request timeout.
import os
from openai import OpenAI

client = OpenAI(
    base_url=os.getenv("OCEANTOKEN_BASE_URL", "https://api.oceantoken.ai/v1"),
    api_key=os.environ["OCEANTOKEN_API_KEY"],
)

with client.chat.completions.create(
    model="deepseek/deepseek-v4.1-flash-1017",
    messages=[{"role": "user", "content": "Count from one to five, one number per line."}],
    stream=True,
) as stream:
    for chunk in stream:
        delta = chunk.choices[0].delta.content if chunk.choices else None
        if delta:
            print(delta, end="", flush=True)
print()

Anthropic SDK로 Claude 사용하기​

# pip install anthropic
# Claude models are served on /v1/messages. The Anthropic SDK works unchanged:
# give it the OceanToken host and your OceanToken key. It adds /v1 itself, so it
# takes the base URL without the /v1 that OpenAI SDKs need.
import os
import anthropic

client = anthropic.Anthropic(
    base_url=os.getenv("OCEANTOKEN_BASE_URL", "https://api.oceantoken.ai/v1").removesuffix("/v1"),
    api_key=os.environ["OCEANTOKEN_API_KEY"],
)

message = client.messages.create(
    model="anthropic/claude-haiku-4.5",
    max_tokens=64,
    messages=[{"role": "user", "content": "Say hello in one short sentence."}],
)
print(message.content[0].text)

같은 코드는 deepseek/deepseek-v4.1-flash-1017 같은 다른 채팅 모델에서도 동작합니다. model만 바꾸세요.

호출할 수 있는 모델 보기​

# The models your key can call, in the standard list format.
curl -sS "${OCEANTOKEN_BASE_URL:-https://api.oceantoken.ai/v1}/models" \
  -H "Authorization: Bearer $OCEANTOKEN_API_KEY"

목록은 키에 따라 달라집니다. 계정에서 특정 모델만 쓸 수 있다면 그 모델만 표시됩니다. 모든 모델은 모델 페이지에, 가격은 oceantoken.ai의 각 모델 페이지에 있습니다.

다음 단계​