> ## Documentation Index > Fetch the complete documentation index at: https://docs.budgetpixel.com/llms.txt > Use this file to discover all available pages before exploring further. # Generate image with Wan 2.7 Pro > Alibaba Wan 2.7 Pro — professional edition of Wan 2.7 with 4K output support, thinking mode, and multi-reference composition from up to 9 reference images. **Asynchronous.** Returns a job `id` (the image is not in this response). Poll [`GET /v1/images/{id}`](/api-reference/images/get-image-job-status) until `status` is `succeeded` — the generated image URLs are in that response's `images` array (each `{ url, position }`). ## OpenAPI ````yaml /openapi.yaml post /images/wan-2.7-pro openapi: 3.1.0 info: contact: email: support@budgetpixel.com name: BudgetPixel Support description: > The BudgetPixel developer API for programmatic image and video generation. Generation is **asynchronous**: you create a job, then poll its status until it reaches a terminal state (`succeeded` / `failed`). You are charged in credits only on success — never for failures, timeouts, or content blocked before generation. **Authentication.** All requests require an API key sent as a bearer token: Authorization: Bearer bpx_live_xxx Create and manage keys from your BudgetPixel account dashboard. The developer API is currently available on the **Ultra** plan. **Pricing.** API usage is metered in credits at each model's published price (see `GET /v1/models`). Consumer subscription perks (free daily generations, free-for-Ultra models, subscription discounts) do not apply to API traffic. title: BudgetPixel API version: '2026-06-20' servers: - description: Production url: https://api.budgetpixel.com/v1 security: - ApiKeyAuth: [] tags: - description: Account and credit balance name: Account - description: Discover available models and pricing name: Models - description: Upload input media for image/video generation name: Uploads - description: Image job status name: Images - description: FLUX image models name: Black Forest Labs - description: SeeDream image models name: Bytedance - description: Video job status name: Videos - description: Kuaishou Kling video models name: Kling - description: SeeDance video models name: ByteDance (SeeDance) - description: Music job status name: Audios - description: Music generation models name: Music - description: Format conversion for images, video, and audio name: Conversions - description: Publish posts to your BudgetPixel feed name: Social - description: Content moderation — NSFW rating and CSAM detection name: Moderation - description: Content classification — music genre detection name: Classification paths: /images/wan-2.7-pro: post: tags: - Alibaba summary: Generate image with Wan 2.7 Pro description: >- Alibaba Wan 2.7 Pro — professional edition of Wan 2.7 with 4K output support, thinking mode, and multi-reference composition from up to 9 reference images. **Asynchronous.** Returns a job `id` (the image is not in this response). Poll [`GET /v1/images/{id}`](/api-reference/images/get-image-job-status) until `status` is `succeeded` — the generated image URLs are in that response's `images` array (each `{ url, position }`). operationId: createImage_wan_2_7_pro requestBody: content: application/json: schema: properties: aspect_ratio: default: '1:1' description: Output aspect ratio. enum: - '1:1' - '16:9' - '9:16' - '4:3' - '3:4' - '3:2' - '2:3' - '21:9' - match_input_image type: string num_images: default: 1 description: Number of images to generate. maximum: 4 minimum: 1 type: integer prompt: description: Text description of the image to generate. type: string reference_images: description: >- Optional reference images (up to 9) for image editing and multi-reference composition. Each item is a public image URL, a data URI, raw base64, or an uploaded-file URL from POST /v1/uploads. Omit for text-to-image. Use aspect_ratio "match_input_image" to keep the input's aspect ratio. items: type: string maxItems: 9 type: array seed: description: Seed for reproducible generation. Omit for random. type: integer size: default: 2K description: >- Output resolution tier. 4K applies to text-to-image only — with reference images the output falls back to 2K. enum: - 1K - 2K - 4K type: string thinking_mode: description: >- Enable the model's thinking mode for stronger prompt planning. Text-to-image only — ignored when reference images are provided. type: boolean required: - prompt type: object required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/CreateImageResponse' description: Job accepted. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '429': $ref: '#/components/responses/TooManyRequests' components: schemas: CreateImageResponse: properties: id: description: Opaque job id — use it to poll status. example: img_a1b2c3d4e5f6 type: string message: type: string model: type: string status: $ref: '#/components/schemas/JobStatus' type: object JobStatus: description: Lifecycle state. `succeeded`/`failed`/`timeout` are terminal. enum: - pending - starting - processing - completing - succeeded - failed - timeout type: string Error: properties: error: properties: code: description: Stable machine-readable code. example: model_not_available type: string message: type: string type: description: Error category. example: invalid_request_error type: string required: - type - code - message type: object required: - error type: object responses: BadRequest: content: application/json: schema: $ref: '#/components/schemas/Error' description: The request was malformed or referenced an unavailable model. Unauthorized: content: application/json: schema: $ref: '#/components/schemas/Error' description: Missing or invalid API key. Forbidden: content: application/json: schema: $ref: '#/components/schemas/Error' description: Authenticated but not permitted (plan gate, ownership, restriction). TooManyRequests: content: application/json: schema: $ref: '#/components/schemas/Error' description: Rate or queue limit reached. Retry after a short delay. securitySchemes: ApiKeyAuth: bearerFormat: bpx_live_* description: 'API key as a bearer token: Authorization: Bearer bpx_live_xxx' scheme: bearer type: http ````