タスクライフサイクルの詳細

以下のリファレンスを参照して、リクエストを構築し、タスクの実行期間中に AI Scraper API が返すすべてのレスポンスを解釈してください。

共通リクエストパラメータ

Parameter	Type	Required	Description
`actor`	string	はい	実行するモデルを示す固定識別子です。
`webhook`	object	いいえ	オプションの Webhook 設定を含むオブジェクトです。
`webhook.url`	string	いいえ	タスク完了時に結果を受信する HTTPS エンドポイントです。
`input`	object	はい	プロンプト、モード、国などのアクター固有のパラメータです。

結果データ構造

Parameter	Type	Required	Description
`status`	string	はい	タスクステータス：`pending`、`running`、`success`、または `failed`。
`message`	string	いいえ	タスクが失敗した場合のエラーメッセージです。
`task_result`	object	いいえ	アクターの完全なペイロードです。フィールドレベルの詳細については、アクターのドキュメントを参照してください。

Webhook プッシュペイロード

webhook.url を設定すると、Scrapeless は以下の JSON 形式で POST リクエストを発行します。

Parameter	Type	Required	Description
`task_id`	string	はい	完了したタスクの識別子です。
`status`	string	はい	`success` または `failed`。
`input`	string	はい	JSON としてシリアライズされた元のタスクパラメータです。
`task_result`	object	いいえ	結果エンドポイントをポーリングする際に受信するものと同じ構造です。

プッシュの例

curl --location '{webhook.url}' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "",
    "status": "",
    "input": "",
    "task_result": {}
  }'

HTTP ステータスコード

Status	Meaning
`200`	成功。結果が取得されました。
`201`	タスクが正常に作成されました。
`202`	タスクはまだ実行中です。しばらくしてから再試行してください。
`400`	無効なリクエストです。詳細についてはエラーメッセージを確認してください。
`410`	タスク結果の有効期限が切れています。
`429`	レート制限を超えました。リクエスト頻度を減らすか、容量をアップグレードしてください。

はじめに ChatGPT