Felo API PlatformFelo API Platform
Exa のエンドポイント一覧
v0.2.0-beta
OpenAPI 3.1.0

非同期のリサーチ Agent 実行を送信

サーバー:https://openapi.felo.ai
クライアントライブラリ

Exa

​

Semantic search, page content, cited answers and asynchronous research.

非同期のリサーチ Agent 実行を送信

​

非同期のリサーチタスクを送信します。query を指定し、任意で systemPrompt と effort(minimal のみ)を指定します。Idempotency-Key は必須です。HTTP 202 はジョブを返します。その id を対応する Felo のポーリングエンドポイントに渡し、completed、failed、cancelled のいずれかになるまで繰り返します。ジョブの価格フィールドはプロバイダーの承認と決済のメタデータであり、Felo の請求記録ではありません。

料金の参考情報

  • 計量方式:固定リクエストの参考値。
  • 参考リクエスト見積もり:USD 0.1。

参考情報のメタデータであり、アカウントへの見積もり、保証された価格、支出上限ではありません。リソースクレジットは Felo クレジットではありません。最終的な請求は Felo の請求記録に従います。

ヘッダー
  • Idempotency-Key
    型: string
    必須

    トリム後の UTF-8 長は 1~191 バイトでなければなりません。

リクエストボディ
必須
application/json
  • query
    型: string
    必須

    空白をトリムした後に空でないクエリ。

  • effort
    型: string | null 列挙値

    minimal effort のみがサポートされます。省略、空、null の値は minimal に正規化されます。

    値
    • null
    • minimal
  • systemPrompt
    型: string | null
レスポンス
  • 202
    型: object

    成功

    • completedAt
      型: string | null 形式: date-time
      必須

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • createdAt
      型: string | null 形式: date-time
      必須

      the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

    • endpoint
      型: string | null
      必須

      プロバイダーのオペレーション識別子。ポーリングにはドキュメント記載の Felo ジョブパスを使用してください。

    • error
      型: object | null
      必須
      • code
        型: string | null
      • message
        型: string | null
    • id
      型: string | null
      必須
    • object
      定数:  
      integration_async_job
      必須
    • output
      必須
    • pricing
      型: object | null
      必須

      マイクロ USD 単位のプロバイダー承認および精算メタデータ。Felo の残高、保留金額、請求書ではありません。

      • authorizedMicrosUSD
        型: integer | null

        Integer numbers.

      • billingMode
        型: string | null
      • currency
        型: string | null
      • finalMicrosUSD
        型: integer | null

        Integer numbers.

    • status
      型: string 列挙値
      必須
      値
      • queued
      • running
      • completed
      • failed
      • cancelled
    • outputExpired
      型: boolean | null
    application/json
  • 400

    リクエストを処理できませんでした。リクエストパラメータを確認してください。

  • 401

    有効な Felo API キーが必要です。

  • 402

    請求要件が満たされていないため、リクエストを続行できません。

  • 403

    このアカウントにはこの操作を行う権限がありません。

  • 429

    リクエストまたは支出の上限に達しました。

  • 502

    サービスがリクエストを完了できませんでした。

  • 503

    API または請求サービスが一時的に利用できません。

  • 504

    リクエストの処理中にサービスがタイムアウトしました。

  • default

    操作に失敗しました。Felo サポートに問い合わせる際は、レスポンスのリクエスト ID を保持してください。

Request Example for post/v1/beta/exa/agent/runs
curl https://openapi.felo.ai/v1/beta/exa/agent/runs \
  --request POST \
  --header 'Idempotency-Key: ' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "query": "Find the official documentation for Go"
}'
{
  "completedAt": null,
  "createdAt": null,
  "endpoint": null,
  "error": {
    "code": null,
    "message": null
  },
  "id": null,
  "object": "integration_async_job",
  "output": null,
  "outputExpired": null,
  "pricing": {
    "authorizedMicrosUSD": null,
    "billingMode": null,
    "currency": null,
    "finalMicrosUSD": null
  },
  "status": "queued"
}
Submit an asynchronous research Agent run.

ヘルプが必要ですか?

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