> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.beatapi.io/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server. # モデルと機能 > 提供モデル、対応するリクエスト形式、提供対象外の API、チャット製品と API の出力が異なる理由を説明します。 # モデルと機能 ## BeatAPI は何を提供していますか？ | カテゴリー | 内容 | | ------ | ---------------------------------------------------------------------------------- | | テキスト | 1 つのキーで 11 のモデルシリーズにアクセスできます。[Text API](/text-api)を参照してください。 | | 画像 | 非同期の生成と編集。[Image API](/image-api)を参照してください。 | | 動画 | モーションコントロールを含む非同期生成。[Video API](/video-api)を参照してください。 | | ワークフロー | Music Video、Ecommerce Video、Video Analysis。[Workflow API](/workflow-api)を参照してください。 | | エフェクト | 公開されている単発のエフェクト処理。[Effect API](/effect-api)を参照してください。 | | リアルタイム | WebRTC によるリアルタイム動画生成。[Realtime API](/realtime-api)を参照してください。 | `GET /v1/models` は、アカウントで有効なテキストモデルを返します。[料金ページ](https://beatapi.io/pricing)には、すべてのモデルと現在の料金を掲載しています。 ## どのリクエスト形式に対応していますか？ 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](/integrations/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 を直ちに返し、完成後に結果を取得します。失敗したタスクの返金も、同期呼び出しでは明確に表しにくい情報です。 ライフサイクルは[開発ガイド](/development)、ポーリングを避ける方法は [Webhooks](/webhooks) を参照してください。 ## チャット製品と API で回答が違うのはなぜですか？ 一般向けのチャット製品は、モデルを中心に構築されたアプリケーションです。API が提供するのはモデルそのものです。 製品側で付加される、次のような機能は自動では付いてきません。 * Web 検索やその他のリアルタイムツール * セッションをまたぐ会話の記憶 * コード実行サンドボックス * 調整済みのシステムプロンプト * アップロードしたファイルの検索 API では会話履歴を自分で管理し、システムプロンプトを設定し、必要に応じてツール呼び出しを組み込みます。機能が欠けているのではなく、アプリケーションとしての組み立てを自分で行う形です。 ## 画像入力、ツール、ストリーミングに対応していますか？ すべてのテキストモデルで `stream: true` によるストリーミングを利用できます。 画像認識とツール呼び出しへの対応はモデルによって異なります。旧 `deepseek-v4-flash-vision-exp` ルートは現在の BeatAPI カタログにはありません。Claude、GPT、Gemini の各シリーズは、幅広くマルチモーダルに対応しています。特定の機能を前提に設計する前に、[Text API](/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 の各シリーズが、所定のコンテキスト長を超えると高い単価になります。 正確な時間帯と境界値は[料金ページ](https://beatapi.io/pricing)の注記に記載しています。各レスポンスの利用記録で、適用された料金を確認できます。 ## 他社で契約済みのモデルを使えますか？ BeatAPI は 1 つのアカウントと 1 つの残高で利用します。他社で取得したキーを接続する仕組みはありません。