Gemini Nano asynchronous Call
API keys with asynchronous image access can submit gemini-3-pro-image-preview through the unified MoonNexAI image-task endpoint. Submission returns a MoonNexAI task ID for subsequent status and result queries. To wait for a Gemini-compatible response in the same HTTP request, use Gemini Nano synchronous requests. Asynchronous requests use support verified for the selected model and group; if unavailable, the request fails before task creation or billing.
asynchronous entrance
| Capacity | Path | Annotations |
|---|---|---|
| Picture asynchronous Generation | /v1/images/generations/async | Submit prompt and return task ID immediately. |
| Query task | /v1/images/tasks/{task_id} | Query status, progress, error and successful results. |
| Get Content | /v1/images/tasks/{task_id}/content | task succeeded and jumped to the result picture. |
Not all API Key or model variants have asynchronous capability. Models, sizes, aspect ratio, resolution and single-time generation are available, which is based on the current API Key, price page and GET /v1/models returns.
Submit task
curl https://moonnexai.com/v1/images/generations/async \
-H "Authorization: Bearer <MOONNEXAI_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3-pro-image-preview",
"prompt": "A premium outdoor lifestyle advertising storyboard proposal board, Chinese typography, warm evening light.",
"size": "16:9",
"resolution": "4K",
"n": 1
}'response will return to task status first:
{
"id": "task_xxx",
"object": "image.generation",
"status": "queued",
"model": "gemini-3-pro-image-preview"
}Query task
curl https://moonnexai.com/v1/images/tasks/task_xxx \
-H "Authorization: Bearer <MOONNEXAI_API_KEY>"Read data[].url only when status=succeeded:
{
"id": "task_xxx",
"object": "image.generation",
"status": "succeeded",
"progress": 100,
"model": "gemini-3-pro-image-preview",
"data": [
{
"url": "https://media-nex.windfimusic.com/image/example.png"
}
]
}Continue polling for submitted, queued or running; read error.message for failed. Results are URLs, so preserve the complete URL. You can also retrieve or download results through /v1/images/tasks/{task_id}/content.