クイックスタート
最初のリクエスト。
- 1
キーを作成
開発者プラットフォームにサインインしてAPIキーを作成します。キーは一度しか表示されないため、安全な場所に保管してください。
- 2
クレジットを追加
リクエストは前払いのクレジットで支払います。残高と利用状況はプラットフォームで確認できます。
- 3
モデルを呼び出す
キーをBearerトークンとして、モデルatomにChat Completionsのリクエストを送信します。
curl https://api.incbury.co.uk/v1/chat/completions \
-H "Authorization: Bearer $INCBURY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "atom",
"messages": [{"role": "user", "content": "Summarise the water cycle in two sentences."}],
"reasoning_effort": "none"
}'ベースURLを設定すれば、OpenAIの公式SDKで利用できます。例では環境変数INCBURY_API_KEYを使っています。
SDK
使い慣れた SDK をそのまま。
incbury パッケージは公式 OpenAI SDK の薄いラッパーで、ベース URL とキーが設定済みです。OpenAI 互換のツールもすべて使えます。
Python
pip install incbury
from incbury import Incbury
client = Incbury() # reads INCBURY_API_KEY
reply = client.chat.completions.create(
model="atom",
messages=[{"role": "user", "content": "Hello, Atom!"}],
)
print(reply.choices[0].message.content)TypeScript と JavaScript
npm install incbury openai
import Incbury from "incbury";
const client = new Incbury(); // reads INCBURY_API_KEY
const reply = await client.chat.completions.create({
model: "atom",
messages: [{ role: "user", content: "Hello, Atom!" }],
});
console.log(reply.choices[0].message.content);または OpenAI SDK のままベース URL だけを変更
from openai import OpenAI
client = OpenAI(base_url="https://api.incbury.co.uk/v1", api_key=os.environ["INCBURY_API_KEY"])モデル
呼び出すモデルについて。
- モデルID
atom- ベースURL
https://api.incbury.co.uk/v1- 認証
Authorization: Bearer atom_…- コンテキストウィンドウ
- 16,384トークン
- 最大出力
- 4,096トークン
- 対応
- チャット、推論の深さ、ストリーミング、関数呼び出し、構造化出力、画像入力、logprobs、埋め込み、ファインチューニング、バッチ、評価
- 非対応
- リアルタイム音声セッション(近日対応)
APIでは現在のAtomのリリースを提供しています。 評価と限界を見る。
リファレンス
エンドポイントとパラメータ。
エンドポイント
POST /v1/chat/completionsChat Completionを作成(ストリーミング対応)POST /v1/responsesウェブ検索、ファイル検索、コードインタープリター、画像ツールを内蔵したステートフルな応答GET /v1/models利用可能なモデルの一覧GET /v1/models/{id}モデルの詳細と制限を取得POST /v1/embeddingsテキストをベクトルに変換POST /v1/moderations有害なコンテンツを含むテキストを分類POST /v1/images/generations画像を生成・編集POST /v1/audio/transcriptions音声をテキストに書き起こしPOST /v1/audio/speechテキストを自然な音声に変換POST /v1/filesバッチ、ファインチューニング、評価、検索用のファイルをアップロードPOST /v1/vector_stores検索とファイル検索のためにファイルをインデックス化POST /v1/batches大規模なジョブを非同期で実行POST /v1/fine_tuning/jobs独自の例で LoRA アダプターを学習POST /v1/evalsデータセットでモデルとファインチューンを評価POST /v1/tokenizeテキストのトークン数を数えるGET /v1/tokenizer/{model}トークナイザーをダウンロード
Chat Completionsのパラメータ
messagesstreamstream_options.include_usagemax_tokensmax_completion_tokenstemperaturetop_pstopnlogprobstop_logprobsreasoning_effortresponse_formattoolstool_choiceuser
メッセージにはsystem、developer、user、assistant、toolのロールを使えます。関数ツールは1リクエストあたり最大64個です。安全に再試行するにはIdempotency-Keyヘッダーを送信してください。リクエストとレスポンスはモデレーションを通過します。
料金
トークン単位の料金。
100万トークンあたりの英ポンド建て料金で、前払いのクレジットから支払います。
| トークン | 100万トークンあたり |
|---|---|
| 入力 | £0.20 |
| キャッシュされた入力 | £0.05 |
| 出力 | £0.80 |
画像、音声、動画、ツール、学習
| 製品 | 100万トークンあたり |
|---|---|
| 埋め込み | £0.02 100 万トークンあたり |
| 画像生成 | £0.03 1 枚あたり |
| 画像編集 | £0.04 1 枚あたり |
| 動画生成 | £0.06 1 秒あたり |
| 音声からテキスト | £0.004 1 分あたり |
| テキストから音声 | £0.01 1,000 文字あたり |
| ウェブ検索ツール | £0.005 1 回あたり |
| ファイル検索ツール | £0.002 1 回あたり |
| コードインタープリターツール | £0.003 1 回あたり |
| ベクトルストレージ | £0.08 1 GB・1 日あたり |
| ファインチューニング | £0.50 学習トークン 100 万あたり |
- ファインチューニングジョブの最低料金は £0.50 です。ファインチューニング済みモデルはベースモデルのトークン料金で提供されます。
- クレジットがなくなると、リクエストはHTTP 402 insufficient_creditsを返します。各レスポンスのx-credits-remainingヘッダーで残高を確認できます。
- 各キーは初期設定で1分あたり60リクエストまで利用でき、キーごとに別の上限を設定できます。
- Incbury Codeも同じクレジットで支払います。
- Incbury Chatには専用のプランがあります。 Chatのプランを比較
Atomで開発を始める。
キーを作成してクレジットを追加すれば、数分で最初のリクエストを送れます。