MCP ツールリファレンス
Beatra MCP サーバーの全ツールを、ツール定義から生成して掲載します。用途、引数、戻り値、クレジット消費の有無を確認できます。
Beatra MCP サーバー（https://mcp.beatra.ai/mcp）は以下のツールを提供します。このページは、ドキュメントを公開するたびに Beatra MCP サーバーのツール一覧から生成されます。最新の一覧は GET https://mcp.beatra.ai/tools、または MCP エンドポイントの tools/list で確認できます。
インストールした Beatra Skill がこのサーバーに接続し、Agent の代わりにツールを呼び出します。ブラウザでのログインは 1 回だけです。設定は Beatra Skill のインストールを参照してください。呼び出す前に何が起きるかを確かめるときはこのページを、呼び出しが失敗したときは トラブルシューティングでエラーコードを確認してください。
引数とツールの説明はツール定義の英語原文のままです。引数名はそのまま渡してください。
各ツールの項目
| 項目 | 意味 |
|---|---|
| クレジット | 呼び出しが成功したときに Beatra クレジットを消費するか。生成の価格は beatra.models.list、ソーシャルデータの価格は beatra.social.tools.get で確認します。 |
| 実行方式 | beatra.tasks.get でポーリングする非同期タスクか、結果をそのまま返すか。 |
| 作用 | 読み取りのみか、アカウントにデータを追加するか、進行中の処理を変更するか。 |
| 再実行 | 同じ呼び出しを繰り返しても結果が変わらないか。タスク系ツールは client_request_id でこれを保証します。 |
| スコープ | ログインで許可されている必要がある権限。不足すると insufficient_scope が返ります。 |
画像
beatra.images.generate
テキストのプロンプトから 1〜4 枚の画像を生成します。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、images:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 任意 | Omit or use 'auto' unless the user explicitly requests a concrete model. An explicit model is evaluated exactly as requested and is never substituted. 既定値： auto指定できる値： auto、gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2、image-01-live、wan2.7-image-pro、wan2.7-image、qwen-image-3.0-pro、qwen-image-3.0、qwen-image-2.0-pro、qwen-image-2.0 |
prompt | string | 必須 | Required prompt containing at least one non-whitespace character. 制限：長さ ≥ 1 |
count | integer | 任意 | Requested output image count. The public range is one through four, and the selected model must support the exact count; Beatra does not split the request. 既定値： 1制限：1–4 |
canvas | ImagePresetCanvas | ImageTargetCanvas | 任意 | Desired output canvas. Presets are quality tiers, and target dimensions may be normalized or vary; inspect output images for actual dimensions. 既定値： {"type":"preset","tier":"2K","aspect":"16:9"} |
seed | integer | 任意 | Optional random seed. Supplying it constrains model eligibility; omit it for model-managed randomness. 制限：0–2147483647 |
negative_prompt | string | 任意 | Optional content or qualities to avoid. Supplying it constrains model eligibility and is rejected when no compatible model is available. |
enhance_prompt | boolean | 任意 | Ask the model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written; an explicit boolean constrains model eligibility. |
palette | array of ImagePaletteColor | 任意 | Three to ten weighted RGB colors. Runtime validation requires the weights to sum exactly to 1.0000. 制限：要素数 3–10 |
output_relationship | ImageOutputRelationship | 任意 | Use independent for unrelated results, or sequence for a related image set. An explicit value constrains model eligibility and is rejected when unsupported. 既定値： independent指定できる値： independent、sequence |
reasoning | boolean | 任意 | Omit or use null to retain the selected model's documented default; an explicit boolean constrains model eligibility. |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Generate one to four images from text without source images. Omit model unless the user explicitly requests one; call beatra.models.list before model or cost comparisons. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
beatra.images.transform
順序付きの参考画像 1〜4 枚とプロンプトから、新しい画像を生成します。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、images:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 任意 | Omit or use 'auto' unless the user explicitly requests a concrete model. An explicit model is evaluated exactly as requested and is never substituted. 既定値： auto指定できる値： auto、gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2、image-01-live、wan2.7-image-pro、wan2.7-image、qwen-image-3.0-pro、qwen-image-3.0、qwen-image-2.0-pro、qwen-image-2.0 |
prompt | string | 必須 | Required prompt containing at least one non-whitespace character. 制限：長さ ≥ 1 |
count | integer | 任意 | Requested output image count. The public range is one through four, and the selected model must support the exact count; Beatra does not split the request. 既定値： 1制限：1–4 |
canvas | ImageTransformPresetCanvas | ImageTargetCanvas | 任意 | Desired output canvas. Preset source inherits the last input image's ratio; the omitted default is 2K at 16:9.既定値： {"type":"preset","tier":"2K","aspect":"16:9"} |
seed | integer | 任意 | Optional random seed. Supplying it constrains model eligibility; omit it for model-managed randomness. 制限：0–2147483647 |
negative_prompt | string | 任意 | Optional content or qualities to avoid. Supplying it constrains model eligibility and is rejected when no compatible model is available. |
enhance_prompt | boolean | 任意 | Ask the model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written; an explicit boolean constrains model eligibility. |
palette | array of ImagePaletteColor | 任意 | Three to ten weighted RGB colors. Runtime validation requires the weights to sum exactly to 1.0000. 制限：要素数 3–10 |
images | array of ImageMediaInputUrl | ImageMediaInputArtifact | ImageMediaInputDataUri | 必須 | Ordered artifact, HTTPS URL, or data URI references. 制限：要素数 1–4 |
output_relationship | ImageOutputRelationship | 任意 | Use independent for unrelated results, or sequence for a related image set. An explicit value constrains model eligibility and is rejected when unsupported. 既定値： independent指定できる値： independent、sequence |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Transform one to four ordered reference images with a prompt; when canvas aspect is source, the last reference anchors the ratio. Omit model unless the user explicitly requests one; call beatra.models.list before model or cost comparisons. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
beatra.images.edit
指示に従ってベース画像を編集します。参考画像や編集する範囲も指定できます。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、images:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 任意 | Omit or use 'auto' unless the user explicitly requests a concrete model. An explicit model is evaluated exactly as requested and is never substituted. 既定値： auto指定できる値： auto、gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2、image-01-live、wan2.7-image-pro、wan2.7-image、qwen-image-3.0-pro、qwen-image-3.0、qwen-image-2.0-pro、qwen-image-2.0 |
prompt | string | 必須 | Required prompt containing at least one non-whitespace character. 制限：長さ ≥ 1 |
count | integer | 任意 | Requested output image count. The public range is one through four, and the selected model must support the exact count; Beatra does not split the request. 既定値： 1制限：1–4 |
canvas | ImageEditPresetCanvas | ImageTargetCanvas | 任意 | Desired output canvas. The default is a 2K tier derived from the first base image's ratio; actual output dimensions remain authoritative. 既定値： {"type":"preset","tier":"2K","aspect":"source"} |
seed | integer | 任意 | Optional random seed. Supplying it constrains model eligibility; omit it for model-managed randomness. 制限：0–2147483647 |
negative_prompt | string | 任意 | Optional content or qualities to avoid. Supplying it constrains model eligibility and is rejected when no compatible model is available. |
enhance_prompt | boolean | 任意 | Ask the model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written; an explicit boolean constrains model eligibility. |
palette | array of ImagePaletteColor | 任意 | Three to ten weighted RGB colors. Runtime validation requires the weights to sum exactly to 1.0000. 制限：要素数 3–10 |
images | array of ImageMediaInputUrl | ImageMediaInputArtifact | ImageMediaInputDataUri | 必須 | Ordered inputs; images[0] is the base and later entries are references. 制限：要素数 1–4 |
edit_regions | array of ImageEditRegion | 任意 | Flat normalized rectangles keyed by an input image_index. Runtime validation enforces cross-coordinate and collection relations. 制限：要素数 1–8 |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Edit images[0] as the base image; later images are ordered references and optional regions use normalized coordinates. Omit model unless the user explicitly requests one; call beatra.models.list before model or cost comparisons. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
beatra.images.understand
1〜8 枚の画像について質問に答えます。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、images:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 任意 | Omit or use 'auto' unless the user explicitly requests a concrete model. An explicit model is evaluated exactly as requested and is never substituted. 既定値： auto指定できる値： auto、MiniMax-M3 |
prompt | string | 必須 | Required question or instruction containing non-whitespace characters. 制限：長さ 1–4000 |
images | array of MediaInputUrl | MediaInputArtifact | ImageUnderstandingDataUri | 必須 | One through eight ordered image inputs. Each admitted image is billed once. 制限：要素数 1–8 |
detail | string | 任意 | Visual detail preference. It does not change Beatra's per-image price. 既定値： default指定できる値： default、low、high |
response_format | string | 任意 | 指定できる値：text、json |
temperature | number | 任意 | 制限：0–2 |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Answer questions about one to eight ordered images, each limited to 10 MiB. Upload a local image with beatra.assets.upload first and pass it as an artifact; use data_uri only for very small images. Successful tasks cost 5 credits per admitted image; detail does not affect price. Omit model unless the user explicitly requests one; call beatra.models.list before model or cost comparisons. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
動画
beatra.videos.enhance_prompt
画像・動画・音声を参考に、動画のプロンプトをより詳しく書き直します。結果は書き直したテキストです。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、videos:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model | any | 任意 | Compatibility input only. Its value and type are ignored in the first release; Beatra resolves the available prompt-enhancement model internally. 既定値： auto |
prompt | string | 必須 | Required creative intent to expand into a production-ready video prompt. 制限：長さ 1–7000 |
duration | integer | 必須 | Target video duration in integer seconds. 制限：4–15 |
aspect_ratio | string | 必須 | Target video aspect ratio. Text-only requests cannot use adaptive. 指定できる値： adaptive、21:9、16:9、4:3、1:1、3:4、9:16 |
first_frame | MediaInputUrl | MediaInputArtifact | MediaInputDataUri | 任意 | Optional strict first-frame context image. |
last_frame | MediaInputUrl | MediaInputArtifact | MediaInputDataUri | 任意 | Optional strict last-frame context image. |
references | array of VideoReference | 任意 | Optional ordered image, video, or audio context. Reference mode and strict-frame mode are mutually exclusive. 制限：要素数 ≤ 11 |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Enhance a creative video prompt from optional image, video, or audio context. This creates an asynchronous text-only task and does not generate video. The model compatibility field is ignored. This asynchronous task consumes Beatra credits; successful completion is charged afterward from actual input and output tokens; failed or canceled tasks are not charged. Submit exactly once, then poll with beatra.tasks.get. Reuse client_request_id only for an identical retry.
beatra.videos.generate
テキストから動画を生成します。対応するモデルでは、音声で動きを駆動できます。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、videos:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 任意 | Use auto for request-dependent selection from the ordered live candidates. A concrete model is evaluated exactly as requested and is never substituted. 既定値： auto指定できる値： auto、minimax-h3、wan3.0-video、wan3.0-video-prime、happyhorse-1.1-t2v、wan2.7-t2v、seedance-2、seedance-2-fast、seedance-2-mini、seedance-2.5 |
negative_prompt | string | 任意 | Content or qualities to avoid when supported by the selected model. 制限：長さ ≤ 500 |
duration | integer | "auto" | 任意 | Requested output duration as integer seconds, or 'auto' when the selected model may choose its documented duration. Omit to use the selected model default. |
aspect_ratio | string | 任意 | Explicit output ratio when the selected model accepts it. Omit for a declared model default, source-derived ratio, or fixed model behavior. 指定できる値： 16:9、9:16、1:1、4:3、3:4、4:5、5:4、21:9、9:21、adaptive |
resolution | string | 任意 | Requested model-defined output resolution tier. Omit to use the selected model's declared default; unsupported tiers are rejected rather than coerced. 指定できる値： 480p、720p、1080p、2k、4k |
seed | integer | 任意 | 制限：0–2147483647 |
enhance_prompt | boolean | 任意 | Ask the selected model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written. |
watermark | boolean | 任意 | Whether generated video should include the model watermark. |
generate_audio | boolean | 任意 | Whether the selected model should generate synchronized audio. |
web_search | boolean | 任意 | Whether the selected model may use web search during generation. |
return_last_frame | boolean | 任意 | Whether to return the generated video's last frame as an image artifact. |
output_format | string | 任意 | Optional output container. Omit or use mp4 for the existing default; models that advertise mov can return MOV without transcoding. 指定できる値： mp4、mov |
prompt | string | 必須 | Required description of the video to generate without source image or video media. 制限：長さ 1–20000 |
audio | MediaInputUrl | MediaInputArtifact | MediaInputDataUri | 任意 | Optional driving audio for models that support audio-conditioned generation. |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Generate from text when there is no source image or video. Supports optional driving audio on compatible models. Omit model unless the user explicitly requests one; call beatra.models.list before model or cost comparisons. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
beatra.videos.animate
1 枚の画像を最初のフレームにして動画を生成します。音声で駆動することもできます。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、videos:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 任意 | Use auto for request-dependent selection from the ordered live candidates. A concrete model is evaluated exactly as requested and is never substituted. 既定値： auto指定できる値： auto、minimax-h3、wan3.0-video、wan3.0-video-prime、happyhorse-1.1-i2v、wan2.7-i2v、seedance-2、seedance-2-fast、seedance-2-mini、seedance-2.5 |
negative_prompt | string | 任意 | Content or qualities to avoid when supported by the selected model. 制限：長さ ≤ 500 |
duration | integer | "auto" | 任意 | Requested output duration as integer seconds, or 'auto' when the selected model may choose its documented duration. Omit to use the selected model default. |
aspect_ratio | string | 任意 | Explicit output ratio when the selected model accepts it. Omit for a declared model default, source-derived ratio, or fixed model behavior. 指定できる値： 16:9、9:16、1:1、4:3、3:4、4:5、5:4、21:9、9:21、adaptive |
resolution | string | 任意 | Requested model-defined output resolution tier. Omit to use the selected model's declared default; unsupported tiers are rejected rather than coerced. 指定できる値： 480p、720p、1080p、2k、4k |
seed | integer | 任意 | 制限：0–2147483647 |
enhance_prompt | boolean | 任意 | Ask the selected model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written. |
watermark | boolean | 任意 | Whether generated video should include the model watermark. |
generate_audio | boolean | 任意 | Whether the selected model should generate synchronized audio. |
web_search | boolean | 任意 | Whether the selected model may use web search during generation. |
return_last_frame | boolean | 任意 | Whether to return the generated video's last frame as an image artifact. |
output_format | string | 任意 | Optional output container. Omit or use mp4 for the existing default; models that advertise mov can return MOV without transcoding. 指定できる値： mp4、mov |
prompt | string | 任意 | Optional motion, scene, and camera instructions for animating the opening image. 制限：長さ ≤ 20000 |
image | MediaInputUrl | MediaInputArtifact | MediaInputDataUri | 必須 | Required strict first-frame image; this is not a loose visual reference. |
driving_audio | MediaInputUrl | MediaInputArtifact | MediaInputDataUri | 任意 | Optional driving audio. Supplying it requires a model that supports this control. |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Animate a first-frame image, optionally with driving audio; use interpolate instead when both first and last frames are supplied. Call beatra.models.list before model or cost comparisons. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
beatra.videos.generate_from_references
順序付きの画像・動画・音声の参考素材から動画を生成します。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、videos:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 任意 | Use auto for request-dependent selection from the ordered live candidates. A concrete model is evaluated exactly as requested and is never substituted. 既定値： auto指定できる値： auto、minimax-h3、wan3.0-video、wan3.0-video-prime、happyhorse-1.1-r2v、wan2.7-r2v、seedance-2、seedance-2-fast、seedance-2-mini、seedance-2.5 |
negative_prompt | string | 任意 | Content or qualities to avoid when supported by the selected model. 制限：長さ ≤ 500 |
duration | integer | "auto" | 任意 | Requested output duration as integer seconds, or 'auto' when the selected model may choose its documented duration. Omit to use the selected model default. |
aspect_ratio | string | 任意 | Explicit output ratio when the selected model accepts it. Omit for a declared model default, source-derived ratio, or fixed model behavior. 指定できる値： 16:9、9:16、1:1、4:3、3:4、4:5、5:4、21:9、9:21、adaptive |
resolution | string | 任意 | Requested model-defined output resolution tier. Omit to use the selected model's declared default; unsupported tiers are rejected rather than coerced. 指定できる値： 480p、720p、1080p、2k、4k |
seed | integer | 任意 | 制限：0–2147483647 |
enhance_prompt | boolean | 任意 | Ask the selected model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written. |
watermark | boolean | 任意 | Whether generated video should include the model watermark. |
generate_audio | boolean | 任意 | Whether the selected model should generate synchronized audio. |
web_search | boolean | 任意 | Whether the selected model may use web search during generation. |
return_last_frame | boolean | 任意 | Whether to return the generated video's last frame as an image artifact. |
output_format | string | 任意 | Optional output container. Omit or use mp4 for the existing default; models that advertise mov can return MOV without transcoding. 指定できる値： mp4、mov |
prompt | string | 任意 | Optional instructions describing how the ordered references should guide the output. 制限：長さ ≤ 20000 |
references | array of VideoReference | 必須 | One to fifty ordered image, video, or audio references. Model-specific kind, count, duration, and combination limits still apply. 制限：要素数 1–50 |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Generate from ordered image, video, and audio references. Use animate for one strict opening image and interpolate for strict first and last frames. Call beatra.models.list before model or cost comparisons. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
beatra.videos.interpolate
指定した最後のフレームで終わる動画を生成します。最初のフレームも指定できます。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、videos:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 任意 | Use auto for request-dependent selection from the ordered live candidates. A concrete model is evaluated exactly as requested and is never substituted. 既定値： auto指定できる値： auto、minimax-h3、wan3.0-video、wan3.0-video-prime、wan2.7-i2v、seedance-2、seedance-2-fast、seedance-2-mini、seedance-2.5 |
negative_prompt | string | 任意 | Content or qualities to avoid when supported by the selected model. 制限：長さ ≤ 500 |
duration | integer | "auto" | 任意 | Requested output duration as integer seconds, or 'auto' when the selected model may choose its documented duration. Omit to use the selected model default. |
aspect_ratio | string | 任意 | Explicit output ratio when the selected model accepts it. Omit for a declared model default, source-derived ratio, or fixed model behavior. 指定できる値： 16:9、9:16、1:1、4:3、3:4、4:5、5:4、21:9、9:21、adaptive |
resolution | string | 任意 | Requested model-defined output resolution tier. Omit to use the selected model's declared default; unsupported tiers are rejected rather than coerced. 指定できる値： 480p、720p、1080p、2k、4k |
seed | integer | 任意 | 制限：0–2147483647 |
enhance_prompt | boolean | 任意 | Ask the selected model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written. |
watermark | boolean | 任意 | Whether generated video should include the model watermark. |
generate_audio | boolean | 任意 | Whether the selected model should generate synchronized audio. |
web_search | boolean | 任意 | Whether the selected model may use web search during generation. |
return_last_frame | boolean | 任意 | Whether to return the generated video's last frame as an image artifact. |
output_format | string | 任意 | Optional output container. Omit or use mp4 for the existing default; models that advertise mov can return MOV without transcoding. 指定できる値： mp4、mov |
prompt | string | 任意 | Optional instructions for the motion ending at the required last frame. 制限：長さ ≤ 20000 |
first_frame | MediaInputUrl | MediaInputArtifact | MediaInputDataUri | 任意 | Optional image that must be the video's first frame. Omit it for a last-frame-only request when the selected model advertises that input combination. |
last_frame | MediaInputUrl | MediaInputArtifact | MediaInputDataUri | 必須 | Required image that must be the video's last frame. |
driving_audio | MediaInputUrl | MediaInputArtifact | MediaInputDataUri | 任意 | Optional driving audio. Supplying it requires a model that supports this control. |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Generate toward a required last frame, optionally constrained by a first frame and driving audio. Use animate when only a first frame exists. Call beatra.models.list before model or cost comparisons. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
beatra.videos.edit
指示に従って既存の動画を編集します。参考素材も使えます。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、videos:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 任意 | Use auto for request-dependent selection from the ordered live candidates. A concrete model is evaluated exactly as requested and is never substituted. 既定値： auto指定できる値： auto、wan3.0-video、wan3.0-video-prime、happyhorse-1.0-video-edit、wan2.7-videoedit、seedance-2、seedance-2-fast、seedance-2-mini、seedance-2.5 |
negative_prompt | string | 任意 | Content or qualities to avoid when supported by the selected model. 制限：長さ ≤ 500 |
duration | integer | "auto" | 任意 | Requested output duration as integer seconds, or 'auto' when the selected model may choose its documented duration. Omit to use the selected model default. |
aspect_ratio | string | 任意 | Explicit output ratio when the selected model accepts it. Omit for a declared model default, source-derived ratio, or fixed model behavior. 指定できる値： 16:9、9:16、1:1、4:3、3:4、4:5、5:4、21:9、9:21、adaptive |
resolution | string | 任意 | Requested model-defined output resolution tier. Omit to use the selected model's declared default; unsupported tiers are rejected rather than coerced. 指定できる値： 480p、720p、1080p、2k、4k |
seed | integer | 任意 | 制限：0–2147483647 |
enhance_prompt | boolean | 任意 | Ask the selected model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written. |
watermark | boolean | 任意 | Whether generated video should include the model watermark. |
generate_audio | boolean | 任意 | Whether the selected model should generate synchronized audio. |
web_search | boolean | 任意 | Whether the selected model may use web search during generation. |
return_last_frame | boolean | 任意 | Whether to return the generated video's last frame as an image artifact. |
output_format | string | 任意 | Optional output container. Omit or use mp4 for the existing default; models that advertise mov can return MOV without transcoding. 指定できる値： mp4、mov |
source_video | MediaInputUrl | MediaInputArtifact | MediaInputDataUri | 必須 | Required video whose existing content will be edited. |
instruction | string | 必須 | Required instruction describing changes to the source video. 制限：長さ 1–20000 |
references | array of VideoReference | 任意 | Optional ordered image, video, or audio references. The selected model must support every supplied reference kind and count. 制限：要素数 ≤ 49 |
audio_setting | string | 任意 | Optional edit-audio policy: auto lets a compatible model choose, while origin requests preservation of source audio. 指定できる値： auto、origin |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Edit one source video by instruction, with optional multimodal references; do not use this to extend a clip. Input plus output duration may be billable. Call beatra.models.list before model or cost comparisons. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
beatra.videos.extend
既存のクリップの前または後ろに、新しい映像を付け足します。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、videos:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 任意 | Use auto for request-dependent selection from the ordered live candidates. A concrete model is evaluated exactly as requested and is never substituted. 既定値： auto指定できる値： auto、wan3.0-video、wan3.0-video-prime、wan2.7-i2v、seedance-2、seedance-2-fast、seedance-2-mini、seedance-2.5 |
negative_prompt | string | 任意 | Content or qualities to avoid when supported by the selected model. 制限：長さ ≤ 500 |
duration | integer | 必須 | Required final returned-video duration in integer seconds. It must exceed the trusted source-video duration; model-specific admission may narrow the range. 制限：2–30 |
aspect_ratio | string | 任意 | Explicit output ratio when the selected model accepts it. Omit for a declared model default, source-derived ratio, or fixed model behavior. 指定できる値： 16:9、9:16、1:1、4:3、3:4、4:5、5:4、21:9、9:21、adaptive |
resolution | string | 任意 | Requested model-defined output resolution tier. Omit to use the selected model's declared default; unsupported tiers are rejected rather than coerced. 指定できる値： 480p、720p、1080p、2k、4k |
seed | integer | 任意 | 制限：0–2147483647 |
enhance_prompt | boolean | 任意 | Ask the selected model to rewrite the prompt before generation. Omit or use null to keep the prompt exactly as written. |
watermark | boolean | 任意 | Whether generated video should include the model watermark. |
generate_audio | boolean | 任意 | Whether the selected model should generate synchronized audio. |
web_search | boolean | 任意 | Whether the selected model may use web search during generation. |
return_last_frame | boolean | 任意 | Whether to return the generated video's last frame as an image artifact. |
output_format | string | 任意 | Optional output container. Omit or use mp4 for the existing default; models that advertise mov can return MOV without transcoding. 指定できる値： mp4、mov |
video | MediaInputUrl | MediaInputArtifact | MediaInputDataUri | 必須 | The single source video to continue. |
direction | string | 必須 | Generate new content immediately before or after the source video's content. 指定できる値： before、after |
instruction | string | 必須 | Required instruction describing how the source video should continue. 制限：長さ 1–20000 |
references | array of VideoReference | 任意 | Optional ordered image, video, or audio references. The selected model must support every supplied reference kind and count. 制限：要素数 ≤ 49 |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Generate footage immediately before or after one source clip. Use edit to alter existing frames. Duration is a required integer final returned-video duration, must exceed the trusted source duration, and does not accept auto. Call beatra.models.list before model or cost comparisons. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
beatra.videos.compose
手持ちのクリップを 1 本の MP4 にまとめます。ナレーション、BGM、焼き込み字幕を加えられます。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、videos:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
clips | array of ComposeClip | 必須 | 制限：要素数 1–12 |
narration | MediaInputArtifact | 任意 | — |
music | ComposeMusic | 任意 | — |
subtitles | array of ComposeSubtitle | 任意 | 制限：要素数 ≤ 200 |
canvas | string | 任意 | 既定値：9:16指定できる値： 9:16、16:9、1:1、3:4 |
model | string | 任意 | 既定値：auto指定できる値： auto、beatra-compose-v1 |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Join your own video clips into one MP4 with optional narration, ducked music, and burned-in subtitles. Set keep_audio on a clip to keep that clip's own sound, such as a lip-synced presenter take; other clips are muted. This call does not consume Beatra credits. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
beatra.videos.understand
1 本の動画について質問に答えます。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、videos:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 任意 | Omit or use 'auto' unless the user explicitly requests MiniMax-M3. 既定値： auto指定できる値： auto、MiniMax-M3 |
prompt | string | 必須 | Required question or instruction containing non-whitespace characters. 制限：長さ 1–32000 |
video | MediaInputUrl | MediaInputArtifact | VideoUnderstandingDataUri | 必須 | The single video input. Beatra samples internally at 1 fps, 0.5 fps from 120 seconds, and 0.2 fps from 240 seconds. |
detail | string | 任意 | Visual detail preference. It does not change Beatra's per-second price. 既定値： default指定できる値： default、low、high |
response_format | string | 任意 | 指定できる値：text、json |
temperature | number | 任意 | 制限：0–2 |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Answer questions about one video limited to 50 MiB and 360 seconds. Upload a local video with beatra.assets.upload first and pass it as an artifact; use data_uri only for very small videos. Beatra samples at 1 fps, or 0.5 fps from 120s and 0.2 fps from 240s; successful tasks cost 0.4 credits per rounded-up admitted second and detail does not affect price. Omit model unless the user explicitly requests one; call beatra.models.list before model or cost comparisons. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
音楽
beatra.music.generate
プロンプトから音楽を生成します。歌詞や参考音声も指定できます。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、music:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model | string | 任意 | Omit unless the user requests a model. 既定値： auto指定できる値： auto、minimax-music-3.0、suno-6、suno-5.5、suno-v6 |
prompt | string | 必須 | Style, mood, genre, and instrumentation. When lyrics are supplied (or Suno custom mode is on) this maps to the provider's style-conditioning field; otherwise it is the song description the model writes the song from. Either way it is not an instruction field: execution directives written here (for example "do not omit anything", "sing it verbatim", "make chapter three differ from chapter one") are not read as instructions and will not be obeyed. Put the words to be sung in lyrics, or set instrumental to true for a track with no vocals.制限：長さ 1–2000 |
lyrics | string | 任意 | Optional lyrics text. Must be omitted for instrumental music. 制限：長さ ≤ 5000 |
instrumental | boolean | 任意 | When true, generate instrumental music without vocals. 既定値： false |
title | string | 任意 | 制限：長さ ≤ 100 |
model_options | MusicModelOptions | 任意 | Options grouped by public music model family. |
reference_audio | MediaInputUrl | MediaInputArtifact | MediaInputDataUri | 任意 | — |
client_request_id | string | 必須 | 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Generate music from a prompt, with optional lyrics or reference audio. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
音声
beatra.speech.prepare_script
テキストを、ボイスとモデルに合わせて感情・間・読みを付けた読み上げ台本にします。台本はそのまま beatra.speech.synthesize に渡せます。ボイスの提案もできます。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、speech:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
input | string | 必須 | Text to perform, in any supported language, 1 to 50,000 characters. It may already contain Beatra speech markup such as {pause 0.5} or {pron 行 hang2}; the AI Director keeps it and only adds to it. The words themselves are never changed. 制限：長さ 1–50000 |
instructions | string | 任意 | Optional requirements in natural language, in any language, up to 2,000 characters, for example "a bit suspenseful, whisper the last line". Without them the AI Director performs the text by its meaning. 制限：長さ ≤ 2000 |
voice | string | 任意 | Optional voice to perform for: a voice_id from beatra.voices.list, a preset or one of your own cloned voices. Same meaning as voice in beatra.speech.synthesize. Omit it to let the AI Director recommend a voice. |
model | string | 任意 | Omit unless the user requests a model. Same values as model in beatra.speech.synthesize; auto or omitted: resolved from the voice, or recommended together with the voice. 既定値： auto指定できる値： auto、minimax-speech-2.8-hd、minimax-speech-2.8-turbo、doubao-seed-tts-2.0、elevenlabs-v4-turbo、elevenlabs-v4 |
language | string | 任意 | Language of the input as a BCP-47 tag. Usually omit it (auto, the default): the language is detected. Send it only when the user names the language or a dialect the text cannot show, such as Cantonese (yue). 既定値： auto制限：長さ 2–32 |
context | SpeechScriptContext | 任意 | Optional, advanced: the text around the input when a long text is directed in parts, used only to understand the tone. It is not annotated, read aloud or returned. The end of before is also suggested as previous_text when the target model supports it. |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Use before beatra.speech.synthesize to make speech sound natural and human. Beatra's AI Director reads the text and the user's optional instructions, then returns a script that is ready to synthesize, written in Beatra speech markup for the target voice and model: emotion, performance, sound effects, pauses and pronunciation. It never changes the words. Without voice or model it recommends one, with alternatives, each with a name, a preview link and a reason. Call beatra.speech.synthesize with each returned script's synthesis object as the arguments, unchanged, plus your own client_request_id; a script whose synthesis is null cannot be synthesized as is (read warnings). To try another voice within two days, call again with the same arguments, changing only voice (and model if needed): the earlier reading is reused and not charged again. This asynchronous task consumes Beatra credits: successful completion is charged afterward from actual tokens; nothing is charged when the result has directed false or reuses an earlier reading. To start, the balance must cover Beatra's estimate for the text (per 1,000 characters, counting at least 1,000) plus that of any other AI Director task in progress, also when an earlier reading is reused; an insufficient_balance refusal states the amount needed. An account runs at most 2 AI Director tasks at a time. Submit exactly once, then poll with beatra.tasks.get. Reuse client_request_id only for an identical retry.
beatra.speech.synthesize
Beatra のボイスでテキストを音声にします。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、speech:generate、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model_options | object | 任意 | Per-model-family passthrough options; opaque to the platform, validated per model |
voice | string | 必須 | Opaque beatra voice_id (preset or cloned) |
input | string | 必須 | Text to synthesize. It may contain speech markup such as {pause 0.5}, {laugh}, {pron 行 hang2} or {sub W3C 万维网联盟}; read the vocabulary and limits from the model card (beatra.models.list). Some models also accept inline emotion and performance markup, listed under script_markup on their card; other models skip it with a warning. Malformed markup is corrected or skipped with a markup_adjusted warning instead of failing the request. Some models accept fewer characters; read constraints.input_max_characters on the model card (ElevenLabs models: 10,000). 制限：長さ 1–50000 |
model | string | 任意 | Omit unless the user requests a model. 既定値： auto指定できる値： auto、minimax-speech-2.8-hd、minimax-speech-2.8-turbo、doubao-seed-tts-2.0、elevenlabs-v4-turbo、elevenlabs-v4 |
language | string | 任意 | Optional BCP-47 language tag, for example zh-CN, yue-HK, or en-US. 'auto' explicitly asks the engine to detect the spoken language. Read supported_languages from the selected model's catalog card. When omitted, the voice or provider chooses the language. 制限：長さ 2–32 |
format | string | 任意 | 既定値：mp3指定できる値： mp3、wav、flac、opus、pcm |
sample_rate | integer | 任意 | 指定できる値：8000、16000、22050、24000、32000、44100 |
speed | number | 任意 | 既定値：1制限：0.5–2 |
volume | number | 任意 | 既定値：1制限：≤ 10、> 0 |
pitch | number | 任意 | Pitch adjustment from -1 to 1: 0 keeps the voice's original pitch, -1 is the lowest and 1 the highest the selected model supports. Use decimals such as 0.25 or -0.5 for subtle tuning. 既定値： 0制限：-1–1 |
emotion | string | 任意 | Provider-neutral discrete speaking emotion 指定できる値： happy、sad、angry、fearful、disgusted、surprised、calm、fluent |
subtitle_enable | boolean | 任意 | Request sentence-level subtitles with the audio. Subtitles are free; when present, output.subtitles carries the subtitle file URL and format. 既定値： false |
direction | string | 任意 | Optional natural-language performance direction for the whole request, for example '像在耳边说悄悄话一样，轻声地说' or 'read it like breaking news'. Models and voices that follow it list direction under controls on their model card (with direction_max_characters); anywhere else it is ignored with an option_ignored warning. Effects vary with the voice and the text and are not a guarantee of intensity. |
previous_text | string | 任意 | Optional text that comes right before this clip, for example the previous line of a dialogue or the previous paragraph, so separate calls keep a continuous tone. It is never spoken and never billed; any length is accepted and only its end is used (previous_text_tail_characters on the model card). Models and voices that do not use it ignore it with an option_ignored warning. |
client_request_id | string | 必須 | 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Synthesize speech using a Beatra voice ID. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry. The input accepts speech markup. Read the vocabulary and limits from the model card returned by beatra.models.list. beatra.speech.validate checks the input before you submit and does not charge credits.
beatra.speech.validate
送信前に音声リクエストを確認します。マークアップを解析し、警告とクレジット価格を返します。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | 読み取りのみ |
| 再実行 | 安全 |
| スコープ | mcp:tools、speech:generate |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
voice | string | 必須 | Opaque beatra voice_id (preset or cloned) |
input | string | 必須 | Text to synthesize. It may contain speech markup such as {pause 0.5}, {laugh}, {pron 行 hang2} or {sub W3C 万维网联盟}; read the vocabulary and limits from the model card (beatra.models.list). Some models also accept inline emotion and performance markup, listed under script_markup on their card; other models skip it with a warning. Malformed markup is corrected or skipped with a markup_adjusted warning instead of failing the request. Some models accept fewer characters; read constraints.input_max_characters on the model card (ElevenLabs models: 10,000). 制限：長さ 1–50000 |
model | string | 任意 | Model to check against (default auto) 既定値： auto指定できる値： auto、minimax-speech-2.8-hd、minimax-speech-2.8-turbo、doubao-seed-tts-2.0、elevenlabs-v4-turbo、elevenlabs-v4 |
language | string | 任意 | BCP-47 language hint 制限：長さ 2–32 |
format | string | 任意 | Audio format the create call would use 既定値： mp3指定できる値： mp3、wav、flac、opus、pcm |
sample_rate | integer | 任意 | Sample rate in Hz for the chosen format 指定できる値： 8000、16000、22050、24000、32000、44100 |
speed | number | 任意 | Speaking rate (0.5 to 2.0) 既定値： 1制限：0.5–2 |
volume | number | 任意 | Volume (0 to 10) 既定値： 1制限：≤ 10、> 0 |
pitch | number | 任意 | Normalized pitch (-1.0 to 1.0) 既定値： 0制限：-1–1 |
emotion | string | 任意 | Emotion preset for the whole request 指定できる値： happy、sad、angry、fearful、disgusted、surprised、calm、fluent |
subtitle_enable | boolean | 任意 | Whether the create call would request subtitles 既定値： false |
direction | string | 任意 | Optional natural-language performance direction for the whole request, for example '像在耳边说悄悄话一样，轻声地说' or 'read it like breaking news'. Models and voices that follow it list direction under controls on their model card (with direction_max_characters); anywhere else it is ignored with an option_ignored warning. Effects vary with the voice and the text and are not a guarantee of intensity. |
previous_text | string | 任意 | Optional text that comes right before this clip, for example the previous line of a dialogue or the previous paragraph, so separate calls keep a continuous tone. It is never spoken and never billed; any length is accepted and only its end is used (previous_text_tail_characters on the model card). Models and voices that do not use it ignore it with an option_ignored warning. |
model_options | object | 任意 | Expert provider options, same as the create call |
戻り値 McpSpeechValidateOutput：valid、warnings、weighted_characters、price_credits、execution、script_markup、limitations、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Check a speech request before paying for it: parse the markup, list warnings, count weighted characters, and return the credit price. This call does not create a task, charge credits, or call the speech engine. The markup vocabulary is on the model card from beatra.models.list.
ボイス
beatra.voices.clone
1 人だけが話すクリアな音声サンプルからボイスクローンを作成します。そのボイスの権利があることをユーザーが確認してから呼び出します。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、voices:write、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
model_options | object | 任意 | Only for model doubao-voice-clone-2.0: {"doubao": {...}} with the model_options.doubao keys its clone card lists in controls. Ignored for every other model. |
sample | MediaInputUrl | MediaInputArtifact | MediaInputDataUri | 必須 | Clean single-speaker voice sample (uploaded artifact or HTTPS URL), ~10s-5min |
prompt | VoiceClonePrompt | 任意 | Optional short aligned excerpt: audio shorter than 8 seconds plus its verbatim transcript. Used only by models whose card sets prompt_accepted=true; other models ignore it and return an option_ignored warning. |
display_name | string | 必須 | 制限：長さ 1–255 |
model | string | 任意 | Clone engine. Omit unless the user explicitly asks for a specific clone engine; 'auto' (the default) lets the platform choose. 既定値： auto指定できる値： auto、minimax-voice-clone、doubao-voice-clone-2.0、elevenlabs-voice-clone |
language | string | 任意 | Optional BCP-47 language hint for the cloned voice 制限：長さ 2–32 |
consent_attested | true | 必須 | Caller asserts it has the rights to clone this voice. Recorded, not verified. |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Clone a voice from a clean single-speaker sample. With the default engine (omit model or use 'auto') the cloned voice is ready for speech as soon as the task succeeds. A few explicitly selected models need a separate paid activation before the voice can be used; the result explains the next step. Call only after the user explicitly confirms they have the rights to clone it, and set consent_attested=true. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
beatra.voices.activate
クローン結果で有効化が必要とされたボイスを有効にします。提示された価格にユーザーが同意してから呼び出します。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、voices:write、wallet:spend、tasks:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
voice_id | string | 必須 | The voice_id from the clone result. 制限：長さ 1–64 |
confirmation_token | string | 任意 | The confirmation_token from the clone result's activation.quote (or a later quote); valid for 24 hours. Omit it to get a new quote; nothing is charged. 制限：長さ 1–1024 |
confirm_credits | integer | 任意 | The quoted price_credits, repeated to confirm the user agreed to exactly that price. 制限：≥ 0 |
client_request_id | string | 必須 | Stable retry identity for this billable operation. Reuse only for the exact same generation arguments. 制限：長さ 1–128 |
戻り値 VoiceActivateOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error、voice、charged_credits、quote
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Activate a cloned voice whose clone result says activation is required (status pending_activation). Voices that are already ready, including every MiniMax clone, every ElevenLabs clone, and every preset voice, never need this; calling it on them charges nothing and changes nothing. The clone result already carries the quote (activation.quote: price, terms, preview, confirmation_token). Only after the user explicitly agrees to the price and terms, call once with voice_id, confirmation_token and confirm_credits; this consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get; reuse the same client_request_id only for an identical retry. Called without confirmation_token (the token is gone or older than 24 hours), it returns a new quote and charges nothing.
beatra.voices.list
音声合成に使えるプリセットのボイスとクローンしたボイスを一覧します。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | 読み取りのみ |
| 再実行 | 安全 |
| スコープ | mcp:tools、voices:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
language | string | 任意 | 制限：長さ ≤ 32 |
gender | string | 任意 | 指定できる値：male、female、neutral |
category | string | 任意 | 指定できる値：preset、cloned |
query | string | 任意 | 制限：長さ ≤ 128 |
model | string | 任意 | Compatible model id |
age_group | string | 任意 | child, youth, adult, or senior |
voice_id | string | 任意 | Exact voice_id 制限：長さ ≤ 64 |
limit | integer | 任意 | Page size 既定値： 50制限：1–500 |
cursor | string | 任意 | voice_id of the last voice on the previous page 制限：長さ ≤ 64 |
use_case | string | 任意 | Voices tagged with this use case |
search | string | 任意 | Case-insensitive text found in the display name or the persona 制限：長さ ≤ 64 |
status | string | 任意 | Which voices to list: ready (default, usable for speech), pending_activation (cloned previews that need activation), expired, or any. 既定値： ready指定できる値： ready、pending_activation、expired、any |
戻り値 VoiceListOutput：voices、default_voice_id、error、next_cursor、total_count
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
List preset and tenant-owned voices available for speech synthesis. By default only voices ready for speech are listed; pass status to include cloned voices that are waiting for activation.
beatra.voices.update
クローンしたボイスの名前を変えるか、ボイスをアカウントの既定にします。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、voices:write |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
voice_id | string | 必須 | 制限：長さ 1–64 |
display_name | string | 任意 | New name for one of this account's cloned voices. 制限：長さ 1–40 |
make_default | boolean | 任意 | true makes this voice the account's default; false or omitted leaves the default as it is. Clearing the default is console-only. |
戻り値 VoiceUpdateOutput：voice_id、display_name、is_default、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Rename one of this account's cloned voices, or make a voice (cloned or preset) the account's default. Call only when the user asked for that change. This call is non-billable and cannot delete a voice; deleting happens in the Beatra console.
アバター
beatra.avatars.list
プレゼンター動画用に保存した人物写真（アバター）と、それぞれに組み合わせたボイスを一覧します。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | 読み取りのみ |
| 再実行 | 安全 |
| スコープ | mcp:tools、artifacts:read |
引数
このツールに引数はありません。
戻り値 AvatarListOutput：avatars、default_avatar_id、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
List the portraits this account saved as avatars for talking-presenter videos, the default first, each with its image artifact and paired voice. Pass image.artifact_id as the portrait to beatra.videos.animate after checking the image against the live model card. This call is read-only and does not charge.
beatra.avatars.save
アカウント内の画像を名前付きのアバターとして保存し、後のプレゼンター動画で使えるようにします。肖像の同意をユーザーが確認してから呼び出します。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、artifacts:write |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
artifact_id | string | 必須 | An image artifact_id in this account, from beatra.assets.upload or an earlier task. 制限：長さ 1–64 |
display_name | string | 必須 | The name the user gave this avatar. 制限：長さ 1–40 |
purpose | string | 任意 | Optional use, such as 'course lecturer'. 制限：長さ ≤ 60 |
voice_id | string | 任意 | Optional voice to pair with this avatar. 制限：長さ 1–64 |
make_default | boolean | 任意 | Also make this the account's default avatar. 既定値： false |
consent_attested | true | 必須 | Set true only after the user confirmed the portrait consent sentence. |
consent_subject | string | 必須 | self: the user is the person pictured. authorized_other: the user has that person's separate consent. 指定できる値： self、authorized_other |
戻り値 AvatarSaveOutput：avatar、default_avatar_id、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Save one image already in this account as a named avatar the user can reuse in later sessions. Call only after the user agreed to save it and confirmed the portrait consent sentence: they are the person pictured (consent_subject=self) or they have that person's separate consent (authorized_other). Saving the same image again updates and returns the same avatar. This call is non-billable and cannot delete anything.
公開ソーシャルデータ
beatra.social.tools.search
プラットフォーム、キーワード、機能カテゴリで、公開ソーシャルデータのツールを検索します。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | 読み取りのみ |
| 再実行 | 安全 |
| スコープ | mcp:tools |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
query | string | 任意 | 制限：長さ ≤ 256 |
platform | string | 任意 | 指定できる値：tiktok、douyin、xiaohongshu、instagram、youtube、twitter |
capability_family | string | 任意 | 指定できる値：content、creator、comments、trends、captions |
limit | integer | 任意 | 既定値：10制限：1–20 |
cursor | string | 任意 | 制限：長さ ≤ 256 |
戻り値 SocialToolsSearchOutput：items、next_cursor、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Search public social data tools by platform, keyword, or capability_family. This call is not billable.
beatra.social.tools.get
公開ソーシャルデータのツール 1 件の引数、schema_hash、クレジット価格を確認します。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | 読み取りのみ |
| 再実行 | 安全 |
| スコープ | mcp:tools |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
operation_key | string | 必須 | 制限：長さ 1–128 |
戻り値 SocialToolsGetOutput：operation、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Read one public social data tool, including its arguments, schema_hash, and credit price. This call is not billable.
beatra.social.execute
公開ソーシャルデータの検索を、タスクとして 1 回実行します。
| クレジット | 消費する |
|---|---|
| 実行方式 | 非同期タスク：終わるまで beatra.tasks.get でポーリング |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools、wallet:spend、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
operation_key | string | 必須 | 制限：長さ 1–128 |
schema_hash | string | 必須 | — |
arguments | object | 任意 | — |
client_request_id | string | 必須 | Submit exactly once, then poll with beatra.tasks.get. 制限：長さ 1–128 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Look up public social data and create a task. This billable call consumes Beatra credits and creates an asynchronous task. Submit exactly once, then poll with beatra.tasks.get. Reuse the same client_request_id only for an identical retry.
モデル
beatra.models.list
1 つの機能で選べるモデルを、最新の設定項目・制限・クレジット価格とともに一覧します。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | 読み取りのみ |
| 再実行 | 安全 |
| スコープ | mcp:tools |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
capability | string | 必須 | Generation capability such as text_to_image. |
include_activation_required | boolean | 任意 | Also list voice clone models that are not in the default list: models whose voices need a separate paid activation before use, and models that must be chosen explicitly and are never picked by auto. 既定値： false |
戻り値 ModelListOutput：account_offer、top_up、capability、default_model、auto、models、max_output_images、max_canvas_pixels、starting_credits、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
List models currently selectable for one Beatra generation capability, including live supported controls, constraints, customer credit prices, and billing basis.
capabilityis required and must be an exact generation capability from this tool's input schema enum. For image prices, select the pricing.options entry whose dimensions match the admitted output; Use before choosing or comparing a model or estimating cost; otherwise keep model=auto.
タスク
beatra.tasks.list
この接続で最近作成したタスクを一覧します。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | 読み取りのみ |
| 再実行 | 安全 |
| スコープ | mcp:tools、tasks:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
cursor | string | 任意 | — |
limit | integer | 任意 | 既定値：10制限：1–50 |
status | string | 任意 | 指定できる値：queued、running、succeeded、failed、canceled |
capability | string | 任意 | — |
戻り値 TaskListOutput：items、next_cursor、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
List recent Beatra tasks created by this MCP connection.
beatra.tasks.get
この接続で作成したタスクを 1 件確認します（状態、結果、課金）。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | 読み取りのみ |
| 再実行 | 安全 |
| スコープ | mcp:tools、tasks:read、artifacts:read |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
task_id | string | 必須 | 制限：長さ ≥ 1 |
戻り値 TaskToolOutput：task_id、status、terminal、resolved_model、usage、billing、task、artifacts、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Read a Beatra task created by this MCP connection.
beatra.tasks.cancel
この接続で作成したタスクをキャンセルします。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | 進行中の処理を変更 |
| 再実行 | 安全 |
| スコープ | mcp:tools、tasks:cancel |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
task_id | string | 必須 | 制限：長さ ≥ 1 |
戻り値 TaskCancelOutput：task_id、status、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Cancel a task created by this MCP connection. In-flight work is canceled only when the remote stop is confirmed; a 409 means continue polling the same task.
クレジット
beatra.wallet.get
アカウントのクレジット残高と、次に期限を迎えるクレジットを確認します。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | 読み取りのみ |
| 再実行 | 安全 |
| スコープ | mcp:tools |
引数
このツールに引数はありません。
戻り値 WalletGetOutput：balance_credits、expiring_credits、non_expiring_credits、next_expiry_at、next_expiry_credits、topup_url、concurrent_task_limit、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Read the current Beatra credit balance for this account, including the next expiring batch. Also returns how many unfinished creations this account can keep at a time. This call is read-only and does not charge. It does not top up, change the wallet, or estimate a generation; use beatra.models.list for prices. On insufficient_balance, relay that error's message instead of calling this tool as a substitute. After the user says they have topped up, call this tool once before retrying: the balance_credits in an earlier refusal is the balance at that moment, not the current one.
beatra.wallet.ledger
クレジットの履歴を新しい順に一覧します（消費、返金、チャージ、失効）。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | 読み取りのみ |
| 再実行 | 安全 |
| スコープ | mcp:tools |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
cursor | string | 任意 | — |
limit | integer | 任意 | 既定値：20制限：1–50 |
戻り値 WalletLedgerOutput：items、next_cursor、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
List this account's credit ledger newest first: charges, refunds, top-ups, and expiry. This call is read-only and does not charge. Page with the returned next_cursor. Ledger amounts are not a price estimate; use beatra.models.list before comparing models or quoting a generation.
アップロード
beatra.assets.upload
ローカルの画像・音声・動画ファイル用に、短時間有効なアップロード先を発行します。アップロードの応答で返る artifact ID を、他のツールの入力に使います。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | アカウントにデータを追加 |
| 再実行 | 呼び出しごとに効果が生じる |
| スコープ | mcp:tools、artifacts:write |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
filename | string | 任意 | 制限：長さ 1–255 |
mime_type | string | 必須 | Exact media MIME type. Published aliases are accepted and normalized to their canonical MIME in the grant and artifact. |
size_bytes | integer | 必須 | Exact local file byte length; the upload must match it. 制限：1–104857600 |
戻り値 AssetUploadOutput：grant_id、upload、media_type、mime_type、size_bytes、expires_at、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Create a short-lived upload grant for an image, audio, or video file. Follow the returned HTTP PUT instructions; its response returns the artifact_id.
Skill のインストール
beatra.installations.register
この接続で使っている Beatra Skill パッケージとバージョンを登録します。
| クレジット | 消費しない |
|---|---|
| 実行方式 | 結果をそのまま返す |
| 作用 | アカウントにデータを追加 |
| 再実行 | 安全 |
| スコープ | mcp:tools |
引数
| 引数名 | 型 | 必須 | 説明 |
|---|---|---|---|
package_slug | string | 必須 | 制限：長さ 1–64 |
package_version | string | 必須 | 制限：長さ 5–64 |
platform | string | 必須 | 制限：長さ 1–64 |
external_installation_ref | string | 必須 | 制限：長さ 1–255 |
channel | any | 任意 | — |
channel_locale | any | 任意 | — |
route | any | 任意 | — |
route_basis | any | 任意 | — |
install_source | any | 任意 | — |
install_source_basis | any | 任意 | — |
environment | any | 任意 | — |
戻り値 InstallationRegisterOutput：package_slug、package_version、recognized、first_seen_at、last_seen_at、error
エラーコードとその対処はエラーとリトライにあります。
Agent に送られるツールの説明（英語原文）
Idempotently register the current Skill package for this authenticated installation, with optional channel, install source, network route and runtime environment. This telemetry call is non-billable.
最終更新