LogoAI Music API
ログイン

API エンドポイント

変更履歴

開発者向けアップデート

API 変更履歴

公開済みの API 機能、互換性に関する注意事項、統合に必要な対応を確認できます。

最新の更新

2026年9月17日

リリース履歴

6 件の更新
  1. 変更
    後方互換POST /v2/generate · /v2/extend · /v2/upload-cover/generateAll models

    拒否されたリクエストは 422 または 500 を返し即時返金

    作成エンドポイントは検証エラーを同期的に返してクレジットを返金するようになり、200 を返して完了しないタスクが残ることはなくなりました。

    変更内容

    • 422 は検証でリクエストパラメータが拒否されたことを意味し、message に修正すべきフィールド（title や extensionStartTime など）が示されます。
    • 500 は一時的な障害を意味します。後で再試行してください。
    • どちらの応答にも data.task_id、data.refunded、workId が含まれ、タスクは FAILED になります。
    • 受理後に失敗したタスク（拡張を含む）は fail_message 付きで FAILED となり、クレジットは自動返金されます。
    • 以前はこのようなリクエストは 200 を返し、タスクが IN_PROGRESS のまま残っていました。

    統合への影響

    422 の場合は指示されたパラメータを修正し、500 の場合は後で再試行してください。どちらの応答にも data.refunded が含まれます。

    エンドポイントのドキュメントを見る
  2. 変更
    後方互換POST /v2/extendAll models

    extend リクエストはテキストと開始時間を正規化し失敗しません

    POST /v2/extend は長すぎる Custom Mode テキストを切り詰め、extensionStartTime を範囲内に収めるため、これらのフィールドで送信が拒否されることはなくなりました。

    変更内容

    • title の上限は 80 文字で、超過分は切り詰められます。
    • prompt の上限は 5000 文字、style は 1000 文字で、超過分は切り詰められます。
    • extensionStartTime は 1 ～（元音声の長さ - 1）秒に収められます。未指定または無効な値は元トラックの終端を使用します。
    • 拡張は元トラックのモデル価格で課金され、chirp-v6（chirp-v5 / chirp-v5-5 トラック）または chirp-v6-mini（それ以前の旧トラック）で生成されます。

    統合への影響

    この更新は後方互換です。切り詰めを避けるため title は 80 文字以内にしてください。

    エンドポイントのドキュメントを見る
  3. 変更
    後方互換POST /v2/generate · /v2/extend · /v2/upload-cover/generatechirp-v3-5 … chirp-v5-5

    旧識別子 chirp-v3-5 ～ chirp-v5-5 は chirp-v6 ファミリーで処理

    廃止されたモデル識別子を送信しているリクエストも引き続き動作し、従来の価格が維持されます。

    変更内容

    • chirp-v5 と chirp-v5-5（12 クレジット）は chirp-v6 で処理されます。
    • chirp-v3-5、chirp-v4-0、chirp-v4-5、chirp-v4-5-plus、chirp-v4-5-all は chirp-v6-mini で処理されます。
    • 各旧識別子は従来どおりの価格（5、8、10、12 クレジット）で課金されます。
    • status、feed、callback の結果に含まれる model_name は、実際に音声を生成した公開モデル名（例：chirp-v6-mini）を常に返します。
    • model フィールドを省略した場合は基本ティアの 5 クレジットで課金され、chirp-v6-mini で処理されます。

    統合への影響

    変更は不要です。都合の良いタイミングで model フィールドを chirp-v6 または chirp-v6-mini に更新してください。

    エンドポイントのドキュメントを見る
  4. 追加
    後方互換POST /v2/generate · /v2/upload-cover/generatechirp-v6 · chirp-v6-mini · chirp-v6-wild

    chirp-v6、chirp-v6-mini、chirp-v6-wild モデル

    現在のモデルラインアップは chirp-v6 ファミリーとなり、generate、upload-cover、extend で利用できます。

    変更内容

    • chirp-v6 はフラッグシップ、chirp-v6-mini は高速で経済的なティア、chirp-v6-wild はより実験的なバリアントです。
    • chirp-v6 と chirp-v6-wild はリクエストごとに 12 クレジット、chirp-v6-mini は 10 クレジットです。
    • テキスト上限は全モデル共通です：カスタム prompt 5000、インスピレーション prompt 3000、style 1000、title 80（upload-cover は 100）。長すぎる入力は拒否されず切り詰められます。
    • chirp-v6 トラックの拡張は同じモデルを使用します。Custom Mode の generate リクエストでは duration フィールドが渡されます。

    統合への影響

    この更新は後方互換です。新規連携では chirp-v6-mini または chirp-v6 をご利用ください。

    エンドポイントのドキュメントを見る
  5. 追加
    後方互換POST /v2/generate · /v2/upload-cover/generatechirp-v6 family

    image_urls による画像から音楽生成

    POST /v2/generate と POST /v2/upload-cover/generate が、トラックの雰囲気を決める参考画像を受け付けるようになりました。

    変更内容

    • image_urls は公開アクセス可能な画像 URL を最大 5 件含む配列で送信します。
    • JPEG、JPG、PNG、WEBP に対応し、1 枚あたり最大 10MB です。
    • 画像はインスピレーションモード（generate）と非カスタムモード（upload-cover）のみで有効です。Custom Mode では無視されます。
    • 画像入力はモデル料金に加えてリクエストごとに 1 クレジット追加されます。
    • 画像を指定した場合テキストプロンプトは任意です。両方を組み合わせて結果を調整できます。

    統合への影響

    この更新は後方互換です。画像で結果を変えたい場合のみ image_urls を追加してください。

    エンドポイントのドキュメントを見る
  6. 追加
    後方互換POST /v2/generatechirp-v5-5

    chirp-v5-5 の生成時間を指定可能に

    chirp-v5-5 のカスタムモードで、楽曲の目標時間を指定できるようになりました。

    変更内容

    • duration フィールドは chirp-v5-5 のカスタムモードでのみ使用できます。
    • 10～360 秒の数値を指定します。
    • 未指定または無効な値の場合は 20 秒が使用されます。
    • 他のモデルとインスピレーションモードでは、このフィールドは無視されます。

    統合への影響

    この更新は後方互換です。既存のリクエストは変更せずに引き続き動作します。

    エンドポイントのドキュメントを見る