Claude Fable 5.2 APIクイックスタート

簡単な手順

認証情報はコードの外で設定し、Messages APIにclaude-fable-5-2を指定します。返されたテキストブロック、stop_reason、usageを確認してください。最小リクエストの結果を検証してから画像やツールを追加します。

• Claudeメッセージ API リファレンス
• Claude プラットフォーム モデルのドキュメント

1. アクセスと小さなテスト入力を準備する

Claude Platform API キーを使用し、ローカル シェルで ANTHROPIC_API_KEY 環境変数として使用できるようにします。統合を検証する際には、架空の制作ブリーフを使用してください。キーは資格情報ストアに属しており、要求ログには含まれないようにする必要があります。

2. 最初のメッセージを送信します

この例を、キーを持つシェルにコピーします。このリクエストでは、不足している入力の短いリストが求められます。出力には複数のコンテンツ ブロックが含まれる場合があるため、テキストを抽出するときにタイプを確認してください。

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-fable-5-2","max_tokens":1024,"messages":[{"role":"user","content":"架空のベーカリーが新商品を告知します。デザインブリーフを書く前に確認すべき項目を三つ挙げてください。"}]}'

3. 実際の応答を検査する

テキストブロックを読み、stop_reasonを確認します。トークン上限で終わった場合は依頼を絞るか上限を見直してください。リクエストID、モデルID、使用トークン数を記録し、公式APIの単価で費用を照合します。

• Fable 5.2 コストの例

4. 機能を一度に 1 つずつ追加します

テキスト リクエストが成功したら、文書化されたビジョン リクエストの形状を使用して 1 つの画像を添付し、既知のラベルに対して応答を検証します。その後ツールを追加します。 Fable 5.2 では適応的思考が使用されており、モデルのドキュメントではサポートされていない強制ツール選択オプションと特定のサンプリング設定が言及されています。最初のリクエストにはこれらのオプションを追加しないでください。

• Claudeビジョンの文書化
• Fable 5.2 API の変更点

5. ハンドオフを読み取り可能な状態に保つ

デザイン パイプラインの場合は、ソース ID、必要なコピー、不明なものを含む短い概要を作成します。ビジュアル制作のために承認済みの制作ブリーフを Ciyo にコピーする前に、担当者に検証してもらいます。受け入れられた結果とソース イメージ ID を保存して、後のリビジョンで決定を再構築できるようにします。

• Ciyo デザインエージェント

自動化する前に小さいリクエストを診断する

認証エラーなら認証情報と組織の選択を確認し、リクエスト形式のエラーなら応答のエラー内容とモデル資料を読みます。ステータス、リクエストID、秘密情報を除いたメッセージを残し、問い合わせ用の記録にキーを書かないでください。

トークン上限で止まったら、依頼した三項目が出力されているかを確かめます。HTTPの成功は、ブリーフ完成の証明ではありません。出力範囲を絞るか上限を調整し、次の結果を確認してからツールを追加します。