クイックスタート

ZylooはOpenAI APIをそのまま話します。あなたのコードが次と通信しているなら api.openai.com、ベースURLを当社のものに向けるだけで完了です。

ベースURL

エージェント型CLI — Claude Code、opencodeなど — は次を指します https://api.zyloo.io。OpenAI形式のクライアントやCursorのようなエディタは次を使います https://api.zyloo.io/v1。

bash

# 1. Install the official SDK (any language)
npm install openai

# 2. Get your key from https://zyloo.io/dashboard
export ZYLOO_KEY=sk-zy-...

# 3. Make your first call
curl https://api.zyloo.io/v1/chat/completions \
  -H "Authorization: Bearer $ZYLOO_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "zyloo/claude-opus-4-7",
    "messages": [{"role": "user", "content": "Hello"}]
  }'

エージェント型コーディングCLIを使っていますか？ベースURLを次に設定し https://api.zyloo.io Zylooのキーを入れ、いつも通り実行してください。

bash

# Claude Code, opencode, and other agentic CLIs
export ANTHROPIC_BASE_URL=https://api.zyloo.io
export ANTHROPIC_API_KEY=$ZYLOO_KEY

# Cursor and other OpenAI-compatible editors
#   Base URL:  https://api.zyloo.io/v1
#   API key:   $ZYLOO_KEY

セキュリティ

認証

すべてのリクエストには、次のヘッダーにベアラートークンを含める必要があります Authorization。キーはプロジェクトごとにスコープされ、ダッシュボードから即座に失効できます。

http

Authorization: Bearer sk-zy-9f3a0e5b...

ローカル開発では、キーを次のファイルに保存することを推奨します .env。ランタイム経由で読み込んでください — キーをソース管理にコミットしないこと。

カタログ

モデル

任意のモデルを正規のZyloo IDで参照できます。すべてのIDは次の名前空間下にあり zyloo/... プロバイダー間で曖昧さがありません。全21モデルの一覧は次にありますモデルページ。

bash

# A few examples — see /dashboard/models for the full list
zyloo/claude-opus-4-7-thinking
zyloo/claude-opus-4-7
zyloo/gpt-5.5
zyloo/gemini-3.5-flash
zyloo/deepseek-v4-pro
zyloo/grok-4.3

bash

curl https://api.zyloo.io/v1/models \
  -H "Authorization: Bearer $ZYLOO_KEY"

ヒント

拡張推論を持つモデルは次で終わります -thinking — 例えば zyloo/claude-opus-4-7-thinking または zyloo/gpt-5.5-xhigh。

エンドポイント

チャット補完

OpenAIと同じJSON形状です /v1/chat/completions。ツール、JSONモード、ビジョン、構造化出力は、すべての互換モデルでサポートされています。

import OpenAI from "openai";

const zyloo = new OpenAI({
  apiKey: process.env.ZYLOO_KEY,
  baseURL: "https://api.zyloo.io/v1",
});

const res = await zyloo.chat.completions.create({
  model: "zyloo/gemini-3.5-flash",
  messages: [
    { role: "system", content: "You are concise." },
    { role: "user",   content: "Summarize this PR..." },
  ],
  temperature: 0.2,
  max_tokens: 512,
});

console.log(res.choices[0].message.content);

リアルタイム

ストリーミング

次を渡すと stream: true OpenAIと同じデルタ形式のServer-Sent Eventsを受け取れます。

const stream = await zyloo.chat.completions.create({
  model: "zyloo/claude-opus-4-7",
  stream: true,
  messages: [{ role: "user", content: "Tell me a story" }],
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

信頼性

エラー

ZylooはOpenAI互換のエラーオブジェクトを返します。一般的なコード：

コード	意味	対処
401	無効なキー	ダッシュボードでローテーション
402	クレジット不足	ウォレットをチャージ
429	レート制限	バックオフ、同系列プロバイダーへルーティング
5xx	アップストリーム障害	idempotency-keyで自動リトライ

リリースの準備はできましたか？

キーを取得して、1分以内にトラフィックの送信を始めましょう。

APIキーを取得

ドキュメント。

クイックスタート

認証

モデル

チャット補完

ストリーミング

エラー

リリースの準備はできましたか？