> ## 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.

# wan2.7-image-pro

> API usage guide for wan2.7-image-pro.

{/* source_model_id: wan2.7-image-pro */}

{/* source_updated_at: 1776289733 */}

**Model ID**

```bash theme={null}
wan2.7-image-pro
```

**Calling method:** sync

# Wan 2.7 Image Pro API Documentation

Wan 2.7 Pro is an advanced image generation model supporting text-to-image and image-to-image capabilities up to 4K resolution.

## 1. API Endpoint & Authentication

**Base URL:** `https://console.gmicloud.ai`
**Endpoint:** `POST /api/v1/ie/requestqueue/apikey/requests`
**Header:**

```text theme={null}
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

## 2. Model Specifications

* **Pricing:** \$0.075 per image
* **Output Format:** Image (JPEG, PNG, WEBP, etc.)
* **Resolution:** 1K, 2K, or 4K

## 3. Generation Modes

### Text-to-Image

Provide a text prompt describing the desired image.

### Image-to-Image

Provide reference images (up to 9) along with optional text prompts. Aspect ratio matches the input image.

## 4. Parameter Reference

| Parameter | Type    | Required | Description                                       |
| :-------- | :------ | :------- | :------------------------------------------------ |
| `text`    | string  | Yes      | Text prompt (max 5,000 characters).               |
| `image`   | image   | No       | Reference image URL or Base64.                    |
| `size`    | string  | No       | Output resolution (1K, 2K, or 4K). Default is 2K. |
| `n`       | integer | No       | Number of images to generate (1-4). Default is 1. |

## 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": "wan2.7-image-pro",
    "payload": {
      "text": "A futuristic cityscape at sunset",
      "size": "4K",
      "n": 1
    }
  }'
```

## 6. Checking Request Status

**Endpoint:** `GET /api/v1/ie/requestqueue/apikey/requests/{request_id}`

* **queued**: Waiting in line.
* **processing**: Generating image.
* **success**: Completed. Find URL in `outcome.media_urls`.
* **failed**: Request failed.