> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gmicloud.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# luma-uni-1.1

> API usage guide for luma-uni-1.1.

{/* source_model_id: luma-uni-1.1 */}

{/* source_updated_at: 1781739195 */}

**Model ID**

```bash theme={null}
luma-uni-1.1
```

**Calling method:** sync

# Luma Uni-1.1 API Documentation

Luma Uni-1.1 is a decoder-only autoregressive transformer where text and image tokens share a single sequence — reasoning and image generation run in the same model. Ranked top-3 on Image Arena across Text-to-Image and Image Edit. Generation time \~30s per image.

## 1. API Endpoint & Authentication

Base URL: [https://console.gmicloud.ai](https://console.gmicloud.ai)
Endpoint: POST /api/v1/ie/requestqueue/apikey/requests
Header:
Authorization: Bearer YOUR\_API\_KEY
Content-Type: application/json

## 2. Model Specifications

* Pricing: $0.0404/image (T2I) | $0.0434/image (edit)
* Output: 2048px (2K) resolution, PNG or JPEG
* Generation time: \~30 seconds
* Features: Text-to-Image, Natural-language Image Editing

## 3. Generation Modes

### Text-to-Image

Provide `prompt` and optional `aspect_ratio`. The model generates a new image from your description.

### Image Editing

Provide `prompt` and an `image` (URL). Describe changes in plain language — swap backgrounds, shift lighting, apply styles — without prompt scaffolding.

## 4. Parameter Reference

| Parameter     | Type   | Required | Description                                               |
| :------------ | :----- | :------- | :-------------------------------------------------------- |
| prompt        | string | Yes      | Describe the image or the edit you want (plain language). |
| aspect\_ratio | enum   | No       | Output aspect ratio. Default: 1:1.                        |
| image         | image  | No       | Source image URL for editing mode.                        |

## 5. Example CURL Request

```bash theme={null}
curl -X POST "https://console.gmicloud.ai/api/v1/ie/requestqueue/apikey/requests" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "luma-uni-1.1",
    "payload": {
      "prompt": "A glass of iced coffee on a marble countertop, morning light streaming through a window",
      "aspect_ratio": "16:9"
    }
  }'
```

## 6. Checking Request Status

```bash theme={null}
Endpoint: GET /api/v1/ie/requestqueue/apikey/requests/{request_id}
```

* queued: Request is waiting to be processed.
* processing: Image generation is in progress (\~30s).
* success: Generation completed. URL available in outcome.media\_urls.
* failed: Image generation failed.