curl --request GET \
--url https://api.aireserve.com/v1/images/edits/{job_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aireserve.com/v1/images/edits/{job_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aireserve.com/v1/images/edits/{job_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "9c3f1a2b-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"object": "image.generation.job",
"kind": "image",
"model": "nano-banana-2-edit",
"status": "succeeded",
"created_at": 1762459200,
"completed_at": 1762459214,
"result": {
"images": [
{
"url": "https://v3.fal.media/files/…/edited.png",
"width": 1024,
"height": 1024
}
]
},
"error": null,
"artifact_expires_at": 1762718414,
"upstream_deleted_at": null
}Get image edit job
Poll an image-edit job by the id the submit call returned. Jobs are scoped to your organization — other organizations’ job ids answer 404. Terminal states are succeeded (output URLs under result) and failed (error carries the provider’s message; nothing is charged).
curl --request GET \
--url https://api.aireserve.com/v1/images/edits/{job_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aireserve.com/v1/images/edits/{job_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aireserve.com/v1/images/edits/{job_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "9c3f1a2b-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"object": "image.generation.job",
"kind": "image",
"model": "nano-banana-2-edit",
"status": "succeeded",
"created_at": 1762459200,
"completed_at": 1762459214,
"result": {
"images": [
{
"url": "https://v3.fal.media/files/…/edited.png",
"width": 1024,
"height": 1024
}
]
},
"error": null,
"artifact_expires_at": 1762718414,
"upstream_deleted_at": null
}Authorizations
Your AI Reserve API key (aireserve_api_…) from the API Keys page in the portal (https://portal.aireserve.com/keys).
Path Parameters
Response
The job. Terminal statuses are succeeded (output URLs under result) and failed (error set).
An asynchronous image-edit job. Submit answers it with status: queued; polling returns the same object until it is terminal.
Job id — the path parameter for GET /v1/images/edits/{job_id}.
image.generation.job image The image-editing model id the job was submitted with.
succeeded and failed are terminal.
queued, running, succeeded, failed Unix seconds.
Unix seconds once the job is terminal.
Set when status is succeeded. The edited image URLs are under images[].url.
Show child attributes
Show child attributes
Set when status is failed. A failed job is never charged.
Unix seconds after which the provider may delete the output; download before then.
Present when a same-weights sibling served the job.
Present alongside served_model.