モデルと機能

BeatAPI は何を提供していますか？

カテゴリー	内容
テキスト	1 つのキーで 11 のモデルシリーズにアクセスできます。Text APIを参照してください。
画像	非同期の生成と編集。Image APIを参照してください。
動画	モーションコントロールを含む非同期生成。Video APIを参照してください。
ワークフロー	Music Video、Ecommerce Video、Video Analysis。Workflow APIを参照してください。
エフェクト	公開されている単発のエフェクト処理。Effect APIを参照してください。
リアルタイム	WebRTC によるリアルタイム動画生成。Realtime APIを参照してください。

GET /v1/models は、アカウントで有効なテキストモデルを返します。料金ページには、すべてのモデルと現在の料金を掲載しています。

どのリクエスト形式に対応していますか？

4 種類あり、すべてのテキストモデルをどの形式でも呼び出せます。

形式	エンドポイント
OpenAI Chat Completions	`POST /v1/chat/completions`
OpenAI Responses	`POST /v1/responses`
Anthropic Messages	`POST /v1/messages`
Gemini 互換	`POST /v1beta/models/{model}:{action}`

既存のコードで使っている形式を選んでください。Claude モデルを OpenAI 形式で呼び出すことも、GPT モデルを Anthropic 形式で呼び出すこともできます。形式は通信上の構造であり、利用できるモデルを制限するものではありません。

意図的に提供していない API は？

/v1/embeddings、/v1/rerank、/v1/audio/* は 404 を返します。実装待ちではなく、公開 API の対象外です。

そのため、チャットモデルと埋め込みモデルを併用するツールでは、埋め込みの接続先を別に用意する必要があります。代表例は AnythingLLM です。通常はツールに付属するローカルの埋め込みモデルを利用します。

画像と動画の生成は OpenAI 互換ですか？

いいえ。BeatAPI の生成 API は、意図的に非同期のタスク方式を採用しています。

POST /v1/images/tasks   ->  201, { "data": { "id": "..." } }
GET  /v1/tasks/{id}     ->  poll until succeeded or failed

同期の /v1/images/generations はありません。数分かかるモデルの処理を 1 回の HTTP リクエスト内で完結させようとすると、進捗を正確に示せなくなるか、タイムアウトします。そのためタスク ID を直ちに返し、完成後に結果を取得します。失敗したタスクの返金も、同期呼び出しでは明確に表しにくい情報です。

ライフサイクルは開発ガイド、ポーリングを避ける方法は Webhooks を参照してください。

チャット製品と API で回答が違うのはなぜですか？

一般向けのチャット製品は、モデルを中心に構築されたアプリケーションです。API が提供するのはモデルそのものです。

製品側で付加される、次のような機能は自動では付いてきません。

Web 検索やその他のリアルタイムツール
セッションをまたぐ会話の記憶
コード実行サンドボックス
調整済みのシステムプロンプト
アップロードしたファイルの検索

API では会話履歴を自分で管理し、システムプロンプトを設定し、必要に応じてツール呼び出しを組み込みます。機能が欠けているのではなく、アプリケーションとしての組み立てを自分で行う形です。

画像入力、ツール、ストリーミングに対応していますか？

すべてのテキストモデルで stream: true によるストリーミングを利用できます。

画像認識とツール呼び出しへの対応はモデルによって異なります。旧 deepseek-v4-flash-vision-exp ルートは現在の BeatAPI カタログにはありません。Claude、GPT、Gemini の各シリーズは、幅広くマルチモーダルに対応しています。特定の機能を前提に設計する前に、Text API のモデル別ページを確認してください。

モデルはどう選べばよいですか？

用途	最初に試すモデル
エージェントによるコーディング	`claude-fable-5-1`、`gpt-5.6-sol`
難しい推論	`claude-opus-5`、`gpt-6-astra`、`deepseek-v4-pro-0813`
日常的なチャット	`claude-sonnet-5`、`gpt-5.6-terra`、`glm-5.3`
大量処理と低コスト	`claude-haiku-4-5-20251001`、`gemini-3.7-flash`、`glm-5.3-flash`
長いコンテキスト	`minimax-m3`、`grok-4.7`、`kimi-k3`
中国語の処理	`qwen3.8-max`、`glm-5.3`、`hy4-preview`

モデル ID は安定しています。シリーズに新世代が追加されると新しい ID が付与され、既存の ID が別の重みのモデルに差し替えられることはありません。

時間帯やコンテキスト長で料金は変わりますか？

一部のモデルでは変わり、どちらの条件も公開しています。

ピーク時間帯では、2 つの DeepSeek HC（高キャッシュ）モデルの料金が、平日の北京時間 09:00–12:00 と 14:00–18:00 に 2 倍になります。通常の有料 DeepSeek モデルは時間帯を問わず同じ料金です。Hunyuan hy3 には毎日の独自の時間帯があります。
コンテキストの段階料金では、GPT-5.6 と Grok の各シリーズが、所定のコンテキスト長を超えると高い単価になります。

正確な時間帯と境界値は料金ページの注記に記載しています。各レスポンスの利用記録で、適用された料金を確認できます。

他社で契約済みのモデルを使えますか？

BeatAPI は 1 つのアカウントと 1 つの残高で利用します。他社で取得したキーを接続する仕組みはありません。