# Felo 生成結果

POST /api/v1/data/tasks/{task_id}/historical

プレゼンテーションを非同期で生成し、その後 PPTX ファイルをエクスポートします。生成とエクスポートの手順は分けてください。作成されたタスクはまだ完成したファイルではありません。

すべての例は [概要](https://openapi.felo.ai/ja/docs/data-api/guides/felo-overview.md) の `FELO_API_KEY` を使用します。呼び出しには **プラットフォーム残高** が使われ、Felo Pro クレジットは使われません。レスポンス例は説明用であり、実際の内容や任意フィールドは変動します。



タスク作成時に返される識別子を使用してください。`TASK_ID` を `task_id` に、`PPT_ID` を `ppt_business_id` に設定してください。`{business_id}` も `ppt_business_id` を意味します。

```bash
TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"
```



## 3. 生成結果を読み取る

`POST /api/v1/data/tasks/{task_id}/historical`

これは **POST** であり、JSON ボディは不要です。

```bash
curl -sS --request POST "https://openapi.felo.ai/api/v1/data/tasks/$TASK_ID/historical" \
  -H "Authorization: Bearer $FELO_API_KEY"
```

```json
{
  "task_id":"example-task-id",
  "task_status":"COMPLETED",
  "history_data":{},
  "error_message":null
}
```

`history_data` を使う前に `task_status` を読み取ってください。履歴ペイロードはタスクによって異なり、null の場合があります。`ai_page_html` と `thread_short_id` は任意です。このレスポンスは、PPTX のダウンロード URL が保証されるものではありません。次にエクスポートを使用してください。



## 有効期間、所有権、課金

- プレゼンテーションは **作成から 7 日後** に期限切れになります。クエリやエクスポートではこの期間は延長されません。プレゼンテーションの `expires_at` と署名付きダウンロード URL の `expires_at` は、異なる有効期間を示します。
- 作成した API アカウントのみが、そのタスクとプレゼンテーションにアクセスできます。存在しない、またはアクセスできないリソースは 404 を返す場合があります。期限切れまたは削除済みのリソースは 410、またはクリーンアップ後に 404 を返す場合があります。
- 生成は生成ページごとに課金されます（`ppt.generate`）。ページ単価では、作成時に 10 ページ分の価格が予約され、実際の成功出力で精算され、未使用の予約分は解放されます。プロンプトで要求するページ数が少なくても、アカウントには予約に十分な利用可能残高が必要です。
- エクスポートには別のリクエスト単価（`ppt.export`）があります。ステータス照会、結果照会、エクスポートステータス照会、削除では新しい課金は発生しません。
- タイムアウト後は、別のプレゼンテーションを作成するのではなく、保存済みのタスクを問い合わせてください。[課金とエラー](https://openapi.felo.ai/ja/docs/data-api/guides/felo-billing.md) を参照してください。