Retrieve a generated image

March 9, 2026

Table of contents

  1. Request Headers
  2. Path parameter
  3. Responses
  4. Image Status Values
  5. Model
  6. Examples
  7. Try It

Use this endpoint to retrieve a generated image. Attempting to retrieve an image that is still processing will return the current status. Poll until image_status_final is true.

To create images, use POST images/create.

https://api.useapi.net/v2/pixverse/images/image_id

Request Headers 
Authorization: Bearer {API token}
Content-Type: application/json
Path parameter
  • image_id is required. Specify the image_id you want to retrieve (from success_ids array returned by POST images/create).
Responses

  • 200 OK

    {
    "image_id": "user:<userid>-pixverse:<email>-image:<number>",
    "image_status": 1,
    "account_id": 12345678,
    "model": "seedream-4.0",
    "prompt": "<prompt>",
    "quality": "1080p",
    "aspect_ratio": "auto",
    "seed": 12345,
    "image_url": "https://media.pixverse.ai/...webp",
    "output_width": 1920,
    "output_height": 1080,
    "customer_img_paths": [],
    "customer_img_urls": null,
    "queue_data": {
        "estimated_gen_time": 60,
        "processing_start_time": "2026-03-08T00:30:00Z",
        "queue_count": 0,
        "queue_time": 1
    },
    "created_at": "2026-03-08T00:30:00Z",
    "updated_at": "2026-03-08T00:31:00Z",
    "image_status_name": "COMPLETED",
    "image_status_final": true
}

  • 400 Bad Request

    {
    "error": "<Error message>",
    "code": 400
}

  • 401 Unauthorized

    {
  "error": "Unauthorized",
  "code": 401
}

  • 404 Not Found

    The image was deleted or not found.

    {
    "error": "The original image has been deleted"
}
Image Status Values
image_status image_status_name image_status_final Description
1 COMPLETED true Image ready, check image_url
5 QUEUED false Waiting in queue
7 MODERATED true Content moderation triggered
9 GENERATING false Image is being generated
10 PROCESSING false Post-processing
Model 
{   // TypeScript, all fields are optional
    image_id: string
    image_status: number
    account_id: number
    asset_id: number
    asset_source: number
    asset_type: number
    create_mode: string
    creation_type: number
    model: string
    prompt: string
    quality: string
    aspect_ratio: string
    seed: number
    image_path: string
    image_url: string
    output_width: number
    output_height: number
    customer_img_paths: string[]
    customer_img_urls: string[] | null
    platform: string
    queue_data?: {
        estimated_gen_time: number
        processing_start_time: string
        queue_count: number
        queue_time: number
    }
    created_at: string
    updated_at: string
    is_collected: boolean
    water_mark: boolean
    media_locked: number
    // added
    image_status_name: string
    image_status_final: boolean
    error: string
}
Examples 
  • curl "https://api.useapi.net/v2/pixverse/images/image_id" \
   -H "Accept: application/json" \
   -H "Authorization: Bearer …"

  • const token = "API token";
const image_id = "image_id to retrieve";
const apiUrl = `https://api.useapi.net/v2/pixverse/images/${image_id}`;
const response = await fetch(apiUrl, {
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
const result = await response.json();
console.log("response", {response, result});

  • import requests
token = "API token"
image_id = "image_id to retrieve"
apiUrl = f"https://api.useapi.net/v2/pixverse/images/{image_id}"
headers = {
    "Content-Type": "application/json",
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
Try It