モデル

OpenAI: gpt-oss-20b (batch)

Markdown · JSON

OpenAI: gpt-oss-20b (batch)

OpenAIの小型の汎用gpt-ossモデルは、推論、コーディング、専門的な作業に向け、テキストを受け取ってテキストを返します。設定可能な推論、関数呼び出し、Structured Outputs、公開された重みのファインチューニングに対応します。

モデルについて

この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。

gpt-oss-20bは、推論と開発者の作業に向けた、OpenAIの小型の汎用モデルで、重みが公開されています。テキストを受け取り、テキストを返します。メーカーは、総パラメータ数を210億、トークンごとのアクティブなパラメータ数を36億と公開しています。gpt-ossファミリーの20b版であり、大型の120b版や、ポリシーに沿って分類するSafeguardモデルとは別です。

メーカーは、ローカルでの用途や専門的な用途と、STEM、コーディング、一般知識を中心としたテキストのみの訓練データを説明しています。たとえば、指定した前提の下でコードの一部を説明し、範囲を絞った変更を提案するタスクがあります。テキスト分析では、明確な基準に照らして説明を比較したり、作業メモを有用な知見の一覧にまとめたりできます。原資料と、読者やアプリケーションの次の段階に必要な結果をモデルに与えてください。

公開された混合エキスパート型のアーキテクチャは、24層、32個のエキスパート、トークンごとに四つのアクティブなエキスパートを持ちます。OpenAIが当初公開したエキスパートの重みのMXFP4形式は、16 GBのメモリに収まるよう設計されています。重みはApache 2.0で公開され、専門的な作業に向けてファインチューニングできます。これらは、メーカーが公開したモデルの特性です。開発者は、特定のアプリケーションが使う構成を仮定せず、モデルの大きさとカスタマイズの用途を区別できます。

OpenAIの文書には、131,072トークンのコンテキストウィンドウ、131,072トークンの最大生成出力、2024年6月1日の知識の基準時点が記載されています。利用できるコンテキストには、提供資料、分析、最終回答を収める必要があります。モデルはlow、medium、highの推論レベルに対応します。必須のHarmony形式は、内部分析と最終応答を別のチャネルに保ち、メーカーは、生の分析をエンドユーザーに直接表示しないよう示しています。

メーカーは、関数呼び出し、Web閲覧、ツールを通じたPythonコードの実行、Structured Outputsを文書化しています。モデルの機能にはストリーミングも挙げられ、文書化されたツール環境には、関数、コードの解釈、MCP接続、Web検索が含まれます。アプリケーションは操作を公開して実行し、次の判断に使う実際の結果を返します。最終テキストでは、提案した行動と、完了した操作および返された証拠を区別してください。

対象を絞った作業では、必要なフィールド、制約、完了基準を定義してください。コードに結び付いた説明や、提供したテキストに結び付いた結論を求め、その後の依頼で欠けているひとつの詳細に対応します。有用な最終成果物は、具体的な編集案、比較、短い報告、構造化した結果などで、必要な事実を保持し、未解決の条件を明示するものです。

Ailoot Ultra · バッチ POST /v1/batches openai/gpt-oss-20b:batch

openai/gpt-oss-20b:batch

OpenAI /openai/gpt-oss-20b:batch

はじめに

OpenAIの小型の汎用gpt-ossモデルは、推論、コーディング、専門的な作業に向け、テキストを受け取ってテキストを返します。設定可能な推論、関数呼び出し、Structured Outputs、公開された重みのファインチューニングに対応します。

対応する入力
テキスト
結果
テキスト

Ailootで利用可能 · 入力とメソッド

Ailoot Ultra · バッチ POST /v1/batches
入力の種類
text
出力の種類
text
出力形式
インラインの results[].response.body JSON
フィールド種類要件値と制限デフォルト
フィールドendpoint種類string要件必須値と制限
/v1/chat/completions
デフォルト—
フィールドmodel種類string要件必須値と制限
openai/gpt-oss-20b:batch
デフォルト—
フィールドrequests種類batch_item[]要件必須値と制限
最小項目数: 1
デフォルト—
フィールドrequests[].custom_id種類string要件必須値と制限デフォルト—
フィールドrequests[].body.messages種類message[]要件必須値と制限デフォルト—
フィールドcompletion_window種類string要件任意値と制限
24h
デフォルト—
フィールドprovider種類object|null要件任意値と制限デフォルト—
フィールドrequests[].body.model種類string要件任意値と制限
openai/gpt-oss-20b:batch, openai/gpt-oss-20b
デフォルト—
フィールドprovider.only種類string[]要件任意値と制限
deepinfra/bf16
デフォルト—
フィールドprovider.allow_fallbacks種類boolean|null要件任意値と制限
false, null
デフォルト—
メソッドのパラメータとライフサイクル
パラメータ仕様
パラメータcontent_type仕様application/json
パラメータrequired仕様endpoint, model, requests
パラメータmaterial_types仕様text
パラメータrepresentation仕様インラインの requests[]。各項目には custom_id と body を指定します
パラメータrequest_endpoint_profile仕様/v1/chat/completions
パラメータfile_material仕様呼び出し元は実際の UTF-8 JSONL をローカルで読み込み、requests[] に格納できます。アップロードの purpose、input_file_id、ファイル参照は使用しません。顧客の素材が存在しない、または空の場合、POST の前に準備を停止します。
パラメータserialization_order仕様endpoint, model, provider(指定されている場合), completion_window(指定されている場合), requests を最後に配置
パラメータoptional_controls仕様provider.only, provider.allow_fallbacks, completion_window
パラメータschema_scope仕様ドキュメントに記載されたインラインの Batch エンベロープに格納する、テキスト Chat Completions のリクエストボディ。

ライフサイクル: asynchronous

GET /v1/batches/{operation_id} · 元の作成レスポンスに実際に含まれる response.id。同じユーザー/キー/グループを使用します

料金

料金情報はリクエストの機能を追加しません。対応するパラメーターは選択したメソッドに記載されています。

高速モード
未指定 高速モードが選択されている場合
Flex モード
未指定 flex モードが選択されている場合
最大推論量
未指定 推論量が最大で、調整に既定値(default)を使用する場合
明示的キャッシュの料金
無効 明示的キャッシュを要求した場合

Ailootの料金

設定別の価格

各料金を表示された条件と照合してください。選択肢となる設定の各組には、いずれか1つの料金を適用します。

設定料金表コンテキストトークン数が次の値を超える場合コンテキストトークン数が次の値以下の場合料金
設定トークンの基本単価料金表基本料金コンテキストトークン数が次の値を超える場合—コンテキストトークン数が次の値以下の場合上限なし料金
入力 · 入力トークン $0.000048 / 1K トークン
出力 · 出力トークン $0.000224 / 1K トークン
入力 · キャッシュ読み取り — / 1K トークン
入力 · キャッシュ書き込み — / 1K トークン
入力 · キャッシュ書き込み、1時間 — / 1K トークン
設定リクエスト長に応じた料金区分 1料金表—コンテキストトークン数が次の値を超える場合0コンテキストトークン数が次の値以下の場合上限なし料金
入力 · 入力トークン $0.000048 / 1K トークン
出力 · 出力トークン $0.000224 / 1K トークン
入力 · キャッシュ読み取り — / 1K トークン
入力 · キャッシュ書き込み — / 1K トークン
入力 · キャッシュ書き込み、1時間 — / 1K トークン

Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →

リクエスト例

Ailoot Ultra · バッチ

curl · 保存済みフィクスチャPython HTTP · 実際の顧客の JSONLPython · 完了した結果をすべて保存する
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json
from pathlib import Path
body=json.loads('{"endpoint":"/v1/chat/completions","model":"openai/gpt-oss-20b:batch","requests":[{"custom_id":"req-0001","body":{"messages":[{"role":"user","content":"Hello!"}],"max_tokens":16}}]}')
Path("batch-request.json").write_text(json.dumps(body,ensure_ascii=False),encoding="utf-8")
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/batches \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @batch-request.json -D batch-response-headers.txt -o batch-create-response.json
import json, os
from pathlib import Path
from urllib.request import Request, urlopen

def prepare_requests(customer_path):
    path = Path(customer_path)
    if not path.is_file(): raise ValueError("Customer JSONL file is missing")
    items = [json.loads(line) for line in path.read_text(encoding="utf-8").splitlines() if line.strip()]
    if not items: raise ValueError("Customer JSONL contains no requests")
    ids = set()
    for item in items:
        if set(item) != {"custom_id", "body"}: raise ValueError("Each item needs custom_id and body")
        cid = item["custom_id"]
        if not isinstance(cid, str) or not cid.strip() or cid in ids: raise ValueError("custom_id must be nonempty and unique")
        ids.add(cid)
        if not isinstance(item["body"], dict) or not item["body"].get("messages"): raise ValueError("Supply actual text messages")
        supplied_model = item["body"].get("model")
        if supplied_model is not None and supplied_model not in ['openai/gpt-oss-20b:batch', 'openai/gpt-oss-20b']: raise ValueError("body.model must be an exact documented caller or wire ID")
    return {"endpoint":"/v1/chat/completions", "model":"openai/gpt-oss-20b:batch", "requests":items}

if __name__ == "__main__":
    material = os.environ.get("AILOOT_BATCH_REQUESTS_JSONL", "")
    if not material: raise SystemExit("Set AILOOT_BATCH_REQUESTS_JSONL to your actual customer file")
    body = prepare_requests(material)
    key = os.environ.get("AILOOT_API_KEY", "")
    if not key: raise SystemExit("Set AILOOT_API_KEY")
    request = Request("https://api.ailoot.ai/v1/batches", data=json.dumps(body, ensure_ascii=False).encode("utf-8"), headers={"Authorization":"Bearer " + key, "Content-Type":"application/json"}, method="POST")
    with urlopen(request) as response:
        raw = response.read()
        Path("batch-create-response.json").write_bytes(raw)
        print(raw.decode("utf-8"))
import json
from pathlib import Path
raw = Path("batch-status-response.json").read_bytes()
response = json.loads(raw)
if response.get("status") != "completed":
    raise SystemExit("Keep the original operation; read its status without resubmitting")
results = response.get("results")
if not isinstance(results, list) or not results:
    raise SystemExit("Preserve the original response; completed results are missing")
Path("batch-results.jsonl").write_text("".join(json.dumps(item, ensure_ascii=False) + "\n" for item in results), encoding="utf-8")
# Preserve batch-status-response.json with aggregate usage and every result/error.

結果を受け取って保存

Ailoot Ultra · バッチ

インラインの results[].response.body JSON

  • GET /v1/batches/{operation_id}
ジョブのステータスを確認
curl · 元の処理のステータス
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
BATCH_OPERATION_ID="$(python3 - <<'PY_ID'
import json
from pathlib import Path
from urllib.parse import quote
response = json.loads(Path("batch-create-response.json").read_text(encoding="utf-8"))
operation = response.get("id")
if not isinstance(operation, str) or not operation: raise SystemExit("No actual original operation ID; preserve the response and do not resubmit")
print(quote(operation, safe=""))
PY_ID
)"
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/batches/$BATCH_OPERATION_ID" \
  -H "Authorization: Bearer $AILOOT_API_KEY" -o batch-status-response.json
完了した結果をすべて保存

返された完全なレスポンス、ファイル、コンテンツ部分をすべて保存してください。

元のステータス JSON の全体、各結果と custom_id、レスポンスまたはエラーボディの全体を保存してください。完了済みの results[] は、絞り込まずに JSONL として保存してください。

元のレスポンスを確認する場合

元の操作 ID を保存してください。503 result_pending_check には X-Should-Retry:false が設定されています。結果が不明な元のバッチを決して再送しないでください。

レスポンスのフィールド
フィールド種類
フィールドresults[].custom_id種類string
フィールドresults[].response.body.choices[].message.content種類string|null
フィールドresults[].error種類object|null
フィールドusage種類object|null
フィールドid種類string
フィールドmodel種類string
フィールドendpoint種類string
フィールドstatus種類string
フィールドrequest_counts種類object
フィールドresults[].id種類string
フィールドresults[].response.status_code種類integer
フィールドresults[].response.request_id種類string
エラーと次の手順
レスポンス条件次の手順
レスポンス400 · invalid_request_error条件ドキュメントに記載されたインラインエンベロープが無効、キーが重複、項目の識別情報が不正、または設定されたモデル機能に矛盾があります。次の手順新しく送信する前に、指摘されたフィールドを修正してください。
レスポンス401 · authentication_error条件無効な API キーです。次の手順利用を許可された Ailoot キーを使用してください。
レスポンス403 · permission_error条件バッチグループを利用できません。次の手順キー/グループの利用権限を確認してください。
レスポンス422 · invalid_request_error条件バッチは残高課金を使用します。サブスクリプションでのバッチ作成は拒否されます。次の手順利用を許可された残高課金グループを使用してください。
レスポンス422 · price_unavailable条件バッチ入力の料金を見積もれません。次の手順レスポンスを保存し、対象 API ファミリーのドキュメントに記載された入力を使用してください。
レスポンス402 · billing_error条件バッチの予約額を確保できません。次の手順新しいリクエストの前に、受付条件の問題を解決してください。
レスポンス503 · price_unavailable条件Batch メソッドの価格/ネイティブ料金を利用できません。次の手順レスポンスを保存してください。価格を別の値に置き換えないでください。
レスポンス503 · api_error条件指定どおりのサプライヤールートを利用できません。次の手順ルートを修復するためにレスポンスを保存してください。
レスポンス503 · result_pending_check条件元の結果の確認が必要です。X-Should-Retry:false。次の手順元の operation_id/id を保存し、そのステータスを読み取ってください。元の POST を決して繰り返さないでください。
レスポンス404 · not_found条件バッチのステータス操作が存在しないか、別の識別主体が所有しています。次の手順元の正確な id と、同じユーザー/キー/グループを使用してください。

エイリアス

モデルのエイリアス

Ailoot Ultra openai/gpt-oss-20b:batch

メソッドパスのエイリアス

上記に表示されたメソッドパスを使用してください。

関連する呼び出し用ID

openai/gpt-oss-20b:batch

FAQ · OpenAI: gpt-oss-20b (batch)
利用できる入力と結果は何ですか?

POST /v1/batches · openai/gpt-oss-20b:batch: text → text

リクエストはどの項目を使用しますか?

POST /v1/batches · openai/gpt-oss-20b:batch: endpoint, model, requests, completion_window, provider

どの制限が適用されますか?

POST /v1/batches · openai/gpt-oss-20b:batch: requests.min_items: 1

詳細を見る

AilootをClaude Code、OpenCode、Hermes、自分のアプリに接続しましょう。

企業とそのプロジェクト群

企業とそのプロジェクト群:数百万の顧客、毎月数十億規模の売上。

トークンを割引価格で購入。

継続利用にサブスクリプション割引。プロモコードでトークン購入が最大50%割引。

サブスクリプション
定期的なリクエストに合う割引プランを選びましょう。
最大50%のプロモコード
購入時にコードを入力すると、実施中のキャンペーンに沿って価格を再計算します。
支出を履歴で確認
各リクエストのモデル、トークン、金額が保存されます。

サブスクリプションを選ぶ · モデルの価格を見る

販売する製品に、 APIを組み込みましょう。

SaaS、アプリ、ボットをAilootの公式サービス提供条件とライセンス契約に基づいて接続できます。再販にはリセラーライセンスを申請できます。

商用アプリ
サービスの有料機能に、文章、画像、動画、音声の生成を組み込めます。
リセラーライセンス
プロジェクトの説明とアクセスの仕組みをお送りください。利用・再販条件の書面を申請できます。
サイトで契約文書を確認
接続前にサービス提供条件、ライセンス契約、データ処理ポリシーを読めます。

リセラーライセンスを申請 · サービス提供条件とライセンス契約