arkor.ai トップページで取得できるエンドポイント。配信内容・呼び出し方・有効期限。
arkor.ai のトップページに「Get your endpoint」ボタンがあります。クリックすると、アカウントもクレジットカードもなしで、その場で動く OpenAI 互換の推論エンドポイントがプロビジョニングされます。
プロビジョニング後、ページに次の 3 つが表示されます。
https://<slug>.arkor.app/v1 形式です。OpenAI 互換なので、任意の OpenAI SDK に baseURL としてそのまま渡せます。model フィールドでリクエストごとにモデルを選べ、現在の id は GET /v1/models で一覧できます。任意の OpenAI クライアントから呼び出せます。
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://<slug>.arkor.app/v1",
apiKey: "<ワンタイムキー>",
});
const res = await client.chat.completions.create({
// エンドポイントと一緒に表示されたモデル id、または GET /v1/models の任意の id。
// `model` を省略してもよく、その場合はエンドポイントのデフォルトモデルが使われます。
model: "<エンドポイントと一緒に表示されたモデル id>",
messages: [{ role: "user", content: "こんにちは" }],
});未知の model 値は 404（コード model_not_found）になるため、プレースホルダ文字列をそのまま送らないでください。一覧の id には 2 つ注意点があります。
claude-*）は上の OpenAI 呼び出しではなく、Anthropic ネイティブの POST /v1/messages ルートで配信されます。chat.completions に送ると、正しいルートを示すメッセージつきの 400 が返ります。ダイアレクトを参照してください。403（コード model_requires_signup）が返ります。サインアップして（ログイン状態で同じボタンをクリックして）利用してください。パラメータ・ストリーミング・ツール呼び出し・エラーコードの完全仕様は Chat Completions API リファレンスにあります。
このセクションと次のセクションは匿名の訪問者に適用されます。ログイン済みの場合はログイン済みユーザーを参照してください。
ボタンをクリックしたブラウザには、httpOnly クッキーで匿名アイデンティティが保持されます。エンドポイントはそのアイデンティティ専用のワークスペースに属し、背後のトークンがページの JavaScript に渡ることはありません。クッキーを消したり別のブラウザに移ると、Cloud からそのエンドポイントは見えなくなりますが、URL と API キー自体は期限まで動き続けます。
404）、キーと保存済み実行履歴ごと削除されます。ログインした状態で同じボタンをクリックすると、代わりに通常のアカウント所有エンドポイントが作られます。エンドポイントはあなたの組織の App Server プロジェクトに作成され、そのプロジェクトの Endpoints タブに表示され、他のプロジェクトのエンドポイントと同じように管理できます。匿名クッキーは使われず、エンドポイントは失効せず、3 エンドポイントの上限も適用されません。クリックのたびに新しいエンドポイントと新しいワンタイムキーが発行されます。
匿名のワンクリックエンドポイントをアカウントに引き継ぐフローはありません。失効しないエンドポイントが必要になったら、サインアップしてプロジェクトを作り、プロジェクトの Endpoints タブから作成してください（上記のとおり、ログイン済みでワンクリックボタンを使っても同じです）。アカウント所有のエンドポイントは失効せず、ラベル付き API キーを複数持て、自分でファインチューニングしたアダプタも配信できます。エンドポイント管理を参照してください。