AgentSky
Log in

Llm Responses

by DataForSEO

dataforseo/llm_responses_submit
Get an API key All Tools

Submit a llm responses task for later retrieval.

Billed per
call
Price
Price: —
Provider
DataForSEO
Timeout
3 min

Overview

Starts an asynchronous llm responses request. Save the returned gateway run ID and supplier task ID and use the matching get operation to retrieve the result.

A task identifier and submission status.

Input

These go in the input object of the run request.

FieldTypeRequiredDescription
user_promptstringYesPrompt for the AI model. the question or task you want to send to the AI model.
model_namestringYesName of the AI model. model_name consists of the actual model name and version name; if the basic model name is specified, its latest version will be set by default; for example, if gpt-4.1 is specified, the gpt-4.1-2025-04-14 will be set as model_name automatically.

Requests up to 1 MB.

Example

Use your own API key and a saved idempotency key for each new job. Replace image or media placeholders with your own publicly reachable HTTPS URLs. Keep the same key and request body when recovering a timeout.

# Set once per job; reuse this key and the identical body after a timeout.
: "${AGENTSKY_IDEMPOTENCY_KEY:?Set a unique, saved key for this job}"
curl --fail-with-body https://gateway.agentsky.dev/v1/run \
  -H "authorization: Bearer $AGENTSKY_API_KEY" \
  -H "content-type: application/json" \
  -H "Idempotency-Key: $AGENTSKY_IDEMPOTENCY_KEY" \
  -d '{"provider":"dataforseo","endpoint":"llm_responses_submit","input":{"model_name":"gpt-4.1-mini","user_prompt":"provide information on how relevant the amusement park business is in France now"}}'
# If status is READY/RUNNING, poll GET /v1/runs/{runId} with the same API key.

Pricing

— per call using your plan when signed in. Read the final customer charge from price.amount.value after the run finishes. A RUNNING response is not the final bill.

Questions