aisplice

機能別

画像

モデルを選び、リクエストをコピーして、画像を受け取ります。以下の内容はすべて選んだモデルに合わせて変わります。

#1. モデルを選ぶ

#3. 結果を取得

送信するとすぐに task_id が返ります。status が completed になるまで数秒ごとにタスクを確認するか、webhook_url を渡せば完了時にこちらから呼び出します。

GET https://www.aisplice.store/v1/images/tasks/{task_id}

GET https://www.aisplice.store/v1/images/tasks/{task_id}/content

成功した場合のみ課金

失敗またはキャンセルされたタスクは自動で返金されます。各タスクの最終的な費用はリクエストログで確認できます。

ステータスの値とポーリング →確認する代わりにコールバックを受け取る →

#うまくいかないとき

  • フィールド名付きの 400：そのオプションはこのモデルでは受け付けられません。手順 2 に表示される値を使ってください。
  • モデルがコンテンツを拒否した場合：プロンプトを言い換えてください。拒否されたリクエストは課金されません。
  • 402：残高がこのリクエストに足りません。ウォレットでチャージしてから再試行してください。
  • 429：ペースを落とし、Retry-After の秒数が経ってから再試行してください。
  • 503 model_not_found：モデル名が間違っているか、モデルがオフラインです。手順 1 から選び直してください。

その他のエラーを調べる →

#参照画像

手順 2 に表示される参照画像フィールドに、公開されている画像 URL を指定します。ローカルファイルは先にアップロードし、返された URL を使ってください。

ローカルファイルのアップロード方法 →

プロダクトに組み込む最初にユーザーに見せるオプションと、後回しにするオプション。
最初にユーザーに見せるべき選択肢まずはプロンプトと料金に影響する設定を 1 つだけ用意し、基本フローが動いてから残りを追加します。+

創作の意図

prompt のようなフィールドは、変更による結果をユーザーが直接理解できるため、UI に置くべきです。

コストの倍率要因

duration、resolution、size、count のようなフィールドは、料金をすでに説明できる状態になってから導入してください。

モード切り替え

image、mask、継続用の ID のようなフィールドはワークフロー自体を変えるため、専用のモードでのみ表示してください。

システム内部の設定

webhook_secret のようなフィールドは日常的なクリエイターではなく統合する開発者向けなので、デフォルトの UI には含めないでください。

  • prompt
    表示するタイミング
    常に。画像タスクの主要な創作入力です。
    推奨デフォルト
    UI で必須にします。
    重要な理由
    結果を直接左右するため、隠すと機能が使えなくなります。
  • size
    表示するタイミング
    出力サイズで課金が変わる場合は、初回リリースから表示します。
    推奨デフォルト
    まずは 1:1 など推奨アスペクト比を 1 つ用意します。
    重要な理由
    コストと出力の構図の両方に影響するため、早い段階で簡単なサイズ選択が必要です。
  • quality
    表示するタイミング
    より高品質または安価なグレードをユーザーが明確に求めてから表示します。
    推奨デフォルト
    サーバー側でモデルのデフォルトのままにします。
    重要な理由
    料金とレイテンシーは変わりますが、通常は初日から用意すべき設定ではありません。
  • n
    表示するタイミング
    バッチ生成が中心的なワークフローである場合のみ表示します。
    推奨デフォルト
    デフォルトは 1。
    重要な理由
    コストがすぐに倍増し、初回の UX が煩雑になりがちです。
  • mask / image
    表示するタイミング
    編集系または参照画像系のプロダクトでのみ表示します。
    推奨デフォルト
    テキストから画像モードでは非表示にします。
    重要な理由
    これらのフィールドはプロダクトを生成から編集に変えるため、基本フローに紛れ込ませるべきではありません。
recommended-rollout.txt
Phase 1
- prompt
- one size or one duration default
- submit -> poll -> content

Phase 2
- one quality or resolution selector
- clear pricing hint

Phase 3
- advanced controls such as reference media, continuation, webhook, or vendor-specific tuning

結果の信頼できる情報源は 1 つに

タスクが完了したら、/content が返すプラットフォーム URL を基準にアプリを統一してください。上流ベンダーの詳細を隠せるうえ、過去の再生も安定します。

まだ解決しませんか？

リクエスト ID かエラーメッセージを送っていただければ、こちらで調査します。

前へチャット次へ動画