Felo API PlatformFelo API Platform

Felo エクスポートステータス

プロバイダー: Felo · プラットフォーム残高で支払い

認証とセットアップ課金とエラー完全なワークフローガイド

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

すべての例は 概要 の FELO_API_KEY を使用します。呼び出しには プラットフォーム残高 が使われ、Felo Pro クレジットは使われません。レスポンス例は説明用であり、実際の内容や任意フィールドは変動します。

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

TASK_ID="YOUR_TASK_ID"
PPT_ID="YOUR_PPT_BUSINESS_ID"

5. エクスポートをポーリングしてダウンロードする

GET /api/v1/data/ppts/{business_id}/export

curl -sS --request GET "https://openapi.felo.ai/api/v1/data/ppts/$PPT_ID/export" \
  -H "Authorization: Bearer $FELO_API_KEY"
ステータス次のアクション
NOT_STARTEDエクスポートを 1 回送信します
PROCESSING待機してから再度 GET でポーリングします
COMPLETEDdownload_url を読み取り、ファイルをダウンロードします
FAILED新しいエクスポートを送信する前に、エラーとタスク状態を確認します
{
  "status":"COMPLETED",
  "download_url":"https://example.com/presentation.pptx?signature=example",
  "expires_at":"2026-11-06T00:30:00Z"
}

サンプル URL は説明用です。レスポンスから実際の署名付き URL を使用してください。この URL は 30 分間 有効です。プレゼンテーションが利用可能な間は、GET のエクスポートステータスで新しいリンクを返すことがあります。ファイルは有効期間内に保存してください。Felo API キーをファイルダウンロードホストに送信しないでください。

有効期間、所有権、課金

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

ヘルプが必要ですか？

  • API・請求・アカウントのご質問はサポートへ。
  • Discord で Felo の開発者と交流できます。
  • 更新履歴 をご覧ください。
  • ボリューム価格や購買についてのご相談は営業窓口へ。
  • LLM での構築をお考えですか？llms.txt をご覧ください。