Rivya Public API v1 で Claude Opus 4.8 を使うための model id claude-opus-4-8-chat、対応入力、パラメータ、Files API ルール、クレジット、レスポンス例です。

API で利用可能テキスト入力対応チャット

API モデル ID

claude-opus-4-8-chat

入力

text

Files API

最小リクエストでは不要

基本クレジット

基本料金（クレジット/100万トークン）：入力 400、出力 2,000 タスクの最終費用は整数クレジットに切り上げられます。

機能

チャット

対応状況

Chat API: 非ストリーミング + SSE ストリーミング

課金

TOKEN_BASED

Prompt 上限

20000 文字

リクエスト仕様

Chat リクエストは一度に 1 つの message を送ります。session 履歴は Rivya が保存するため、raw messages array は送らないでください。

Key	型	必須	デフォルト	説明
model	string	はい	claude-opus-4-8-chat	claude-opus-4-8-chat を API モデル ID として使用します。
session_id	string	いいえ	-	API で作成されたチャットセッション ID。省略すると新しいセッションを開始します。
message	string	はい	-	次のユーザーメッセージです。Chat API の履歴は生の messages 配列ではなく、サーバー側セッションから取得されます。
attachments	array	いいえ	-	Files API が返す、必要に応じて指定する画像 file_id 値です。外部添付 URL は受け付けません。
enable_web_search	boolean	いいえ	false	選択した Chat モデルが Web 検索に対応している場合のみ適用されます。
reasoning_effort	string	いいえ	default	必要に応じて指定する reasoning effort: 対応している場合は default、minimal、low、medium、high、xhigh を指定できます。
client_request_id	string	いいえ	-	自社システム内でリクエストを追跡するための任意のクライアント側 ID です。
thought_mode	string	いいえ	default	thought_mode は任意です。default、on、off を指定できます。思考機能に対応するモデルでは、on で有効、off で無効になり、default ではモデルの既定の動作を使います。それ以外のモデルでは、このフィールドは無視されます。
tool_slug	string	いいえ	-	Rivya にあるチャットツールの slug を任意で指定できます。Rivya はそのツールの指示を今回のターンに追加します。セッションにツールが設定済みの場合は、このフィールドを省略するか、同じ slug を指定してください。

モデルパラメータ

この Chat モデルは上記の共通 Chat API フィールドを使います。Web 検索、画像 file 添付、thoughts、reasoning のモデル別対応状況は readiness データに反映されます。

最小リクエスト

{
  "model": "claude-opus-4-8-chat",
  "message": "製品画像を使ったキャンペーンを始めるための3つの手順をまとめてください。"
}

作成レスポンス

Chat エンドポイントは完了した assistant メッセージ、トークン使用量、このターンの最終クレジット精算を返します。

{
  "id": "chatcmpl_assistant_message_id",
  "object": "chat.completion",
  "session_id": "chat_session_claude_opus_4_8_chat",
  "model": "claude-opus-4-8-chat",
  "created_at": "2026-05-11T00:00:00.000Z",
  "message": {
    "id": "assistant_message_id",
    "role": "assistant",
    "content": "1. 製品画像を選ぶ。2. 発表用の投稿を書く。3. 公開を予約し、結果を確認する。",
    "created_at": "2026-05-11T00:00:00.000Z"
  },
  "usage": {
    "input_tokens": 1200,
    "output_tokens": 320,
    "total_tokens": 1520
  },
  "credits": {
    "reserved": 0,
    "final": 0,
    "settlement_status": "PENDING"
  }
}

一般的なエラー

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found, chat_model_not_supported, chat_session_conflict, chat_attachment_not_supported

Chat API は Public API v1 で non-streaming と SSE streaming のターンに対応しています。この Chat モデルは画像添付に対応していません。

Claude Opus 4.8 API 連携

リクエスト仕様

モデルパラメータ

最小リクエスト

作成レスポンス

一般的なエラー

関連 API ドキュメント