Kimicode：5分で初リクエスト

ベース URL と認証

まず、クライアントをベースURLの https://api.kimicode.top/v1 に設定してください。すべてのリクエストにはAPIキーが必要です。サイト上で Get API key をクリックしてキーを生成してください。Googleログイン、またはメールアドレスとパスワードを使用します。電話番号は必要ありません。キーは作成直後に表示されます。安全に保管してください。アカウントごとにアクティブなキーは1つだけです。新しいキーを生成すると、古いキーは無効になります。キーは Authorization ヘッダーにベアートークンとして渡してください。

初リクエスト

チャット完了エンドポイントに最初のプロンプトを送信してください。モデルIDは uncensored を使用してください。APIは標準的なOpenAI互換形式を受け付けます。入力するとテキストが返されます。エラーと拒否は無料なので、成功したトークン使用分のみ課金されます。簡単なプロンプトで接続性をテストしてください。

コピーcurl https://api.kimicode.top/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

キーが無効な場合は 401 エラー、クレジットがない場合は 402 エラーが発生します。リクエストが予期せず失敗した場合はアカウント残高を確認してください。

Python SDK 統合

公式の OpenAI Python SDK を使用してください。ベース URL をエンドポイントに設定し、API キーを渡してください。クライアントはリクエスト形式を自動的に処理します。これは OpenAI 互換クライアントをサポートするあらゆる言語で機能します。pip を介してライブラリをインストールし、ベース URL とキーでクライアントを設定してください。チャット完了エンドポイントを使用してメッセージを送信します。レスポンスには生成されたテキストが含まれます。レスポンスオブジェクトからコンテンツを直接解析できます。

コピーfrom openai import OpenAI

client = OpenAI(base_url="https://api.kimicode.top/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

コードで例外を適切に処理してください。ネットワークの問題やレート制限により、再試行が必要になる場合があります。

Node SDK の使用方法

Node.js SDK も同様に動作します。クライアントをインポートし、ベース URL と API キーを設定してください。チャット完了メソッドを呼び出し、モデル ID とメッセージ配列を渡してください。レスポンス構造は OpenAI 形式に一致します。アシスタントメッセージのコンテンツを抽出してください。このアプローチはサーバーサイドの生成やエッジ関数で機能します。ベース URL の変更以外に追加設定は不要です。

コピーimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.kimicode.top/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

ステータスコードを確認してエラーを処理してください。レート制限は 429 を返し、資金不足は 402 を返します。

ストリーミングレスポンス

stream: true を設定してストリーミングを有効にします。APIはServer-Sent Events (SSE) を返します。各チャンクには部分的なコンテンツが含まれます。トークン使用の詳細は最後のチャンクに表示されます。これにより、長い出力の知覚されるレイテンシが削減されます。ストリームの終了を適切に処理してください。ストリームが終了したとき、またはエラーが発生したときに接続を閉じます。SSEをサポートするすべての標準クライアントでストリーミングが機能します。

コピーstream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

クライアントがチャンクを正しくバッファリングしていることを確認してください。コンテンツを連結して最終レスポンスを形成してください。

制限、エラー、コンテキスト

コンテキストウィンドウは合計100,000トークンです。1つのリクエストあたりの最大出力は32,000トークンです。max_tokens が未設定の場合は2,048に設定してください。レート制限はキーあたり1分あたり300リクエストです。同時実行数の制限は8つの同時リクエストです。リクエストボディの最大サイズは8 MBです。エラーには、無効なキーの場合の401、クレジットがない場合の402、レート制限の場合の429が含まれます。クレジットは期限切れになりません。エラーは無料です。サブスクリプションの罠はありません。