• メッセージ
  • マネージドエージェント
  • 管理

Search...
⌘K
はじめに
Claude入門クイックスタート
Claudeで構築する
機能の概要Messages APIの使用停止理由とフォールバック拒否とフォールバックフォールバッククレジット
モデルの機能
拡張思考適応型思考エフォートタスクバジェット(ベータ版)高速モード(リサーチプレビュー)構造化出力引用メッセージのストリーミングバッチ処理検索結果拒否のストリーミング多言語サポート埋め込み
ツール
概要ツール使用の仕組みチュートリアル:ツール使用エージェントの構築ツールの定義ツール呼び出しの処理並列ツール使用ツールランナー(SDK)厳密なツール使用プロンプトキャッシングを使ったツール使用サーバーツールトラブルシューティングウェブ検索ツールウェブ取得ツールコード実行ツールアドバイザーツールメモリツールBashツールコンピュータ使用ツールテキストエディタツール
ツールインフラストラクチャ
ツールリファレンスツールコンテキストの管理ツールの組み合わせツール検索プログラムによるツール呼び出しきめ細かいツールストリーミング
コンテキスト管理
コンテキストウィンドウコンパクションコンテキスト編集プロンプトキャッシング会話途中のシステムメッセージオーケストレーションモードの構築キャッシュ診断(ベータ版)トークンカウント
ファイルの操作
Files APIPDFサポート画像とビジョン
スキル
概要クイックスタートベストプラクティスエンタープライズ向けスキルAPIでのスキル
MCP
リモートMCPサーバーMCPコネクタ
クラウドプラットフォーム上のClaude
Amazon BedrockAmazon Bedrock(レガシー)AWS上のClaude PlatformMicrosoft FoundryVertex AI

Log in
拒否のストリーミング
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Amazon Bedrock
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
メッセージ/モデルの機能

ストリーミングの拒否

Claude 4モデル以降、ClaudeのAPIからのストリーミングレスポンスは、ストリーミング分類器が潜在的なポリシー違反を処理するために介入した場合に stop_reason: "refusal" を返します。この新しい安全機能は、リアルタイムストリーミング中のコンテンツコンプライアンスの維持に役立ちます。



Claude Sonnet 4.5のAPI安全フィルターによってトリガーされる拒否について詳しくは、Sonnet 4.5のAPI安全フィルターについてを参照してください。

APIレスポンス形式

ストリーミング分類器がAnthropicのポリシーに違反するコンテンツを検出すると、APIは次のレスポンスを返します。

{
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "Hello.."
    }
  ],
  "stop_reason": "refusal"
}


追加の拒否メッセージは含まれません。レスポンスを処理し、ユーザー向けの適切なメッセージを提供する必要があります。

拒否後のコンテキストのリセット

stop_reason: refusal を受け取った場合、続行する前に会話のコンテキストをリセットする必要があります。拒否をトリガーしたターンを削除または言い換えるか、会話履歴を完全にクリアすることができます。リセットせずに続行しようとすると、拒否が継続されます。



レスポンスが拒否された場合でも、使用状況メトリクスはレスポンスに含まれます。

Claudeが出力を生成する前に拒否が発生した場合、Claude APIではそのリクエストに対して課金されず、そのレスポンス内の使用量カウントは情報提供のみを目的としています。拒否の前にClaudeが出力を生成した場合は、そのリクエストに対して課金されます。



Claude Sonnet 4.5またはOpus 4.1(非推奨)の使用中にrefusalのstop reasonが頻繁に発生する場合は、使用制限が異なるHaiku 4.5(claude-haiku-4-5-20251001)を使用するようにAPI呼び出しを更新してみてください。詳しくは、Sonnet 4.5のAPI安全フィルターについてを参照してください。

実装ガイド

アプリケーションでストリーミングの拒否を検出して処理する方法は次のとおりです。

client = anthropic.Anthropic()
messages = []


def reset_conversation():
    """Reset conversation context after refusal"""
    global messages
    messages = []
    print("Conversation reset due to refusal")


try:
    with client.messages.stream(
        max_tokens=1024,
        messages=messages + [{"role": "user", "content": "Hello"}],
        model="claude-opus-4-8",
    ) as stream:
        for event in stream:
            # メッセージデルタ内の拒否を確認
            if event.type == "message_delta":
                if event.delta.stop_reason == "refusal":
                    reset_conversation()
                    break
except Exception as e:
    print(f"Error: {e}")

現在の拒否タイプ

APIは現在、拒否を3つの異なる方法で処理しています。

拒否タイプレスポンス形式発生タイミング
ストリーミング分類器による拒否stop_reason: refusalストリーミング中にコンテンツがポリシーに違反した場合
API入力および著作権の検証400エラーコード入力が検証チェックに失敗した場合
モデル生成による拒否標準テキストレスポンスモデル自体が拒否を判断した場合


将来のAPIバージョンでは、stop_reason: refusal パターンが拡張され、すべてのタイプで拒否処理が統一される予定です。

ベストプラクティス

  • 拒否を監視する:エラー処理に stop_reason: refusal のチェックを含めます
  • 自動的にリセットする:拒否が検出されたときに自動的にコンテキストをリセットする仕組みを実装します
  • カスタムメッセージを提供する:拒否が発生した際のUXを向上させるために、ユーザーフレンドリーなメッセージを作成します
  • 拒否パターンを追跡する:拒否の頻度を監視して、プロンプトの潜在的な問題を特定します

移行に関する注意事項

  • 将来のモデルでは、このパターンが他の拒否タイプにも拡張される予定です
  • 拒否レスポンスの将来的な統一に対応できるように、エラー処理を計画してください

Was this page helpful?

  • APIレスポンス形式
  • 拒否後のコンテキストのリセット
  • 実装ガイド
  • 現在の拒否タイプ
  • ベストプラクティス
  • 移行に関する注意事項