# DreamImage 2.0 ## --- TAB: API Reference --- POST https://api.newportai.com/api/async/dreamimage_2.0

The DreamImage 2.0 API enables AI-powered image editing using natural language prompts. Given an input image and a text description of the desired edit, the model generates a modified version of the image that reflects the requested changes while preserving the original structure and content.

Submit a POST request to the DreamImage 2.0 API to obtain a taskId.
Submit a POST request to the Polling API to retrieve the editing results.
Configure a Callback URL to receive results automatically on completion.

## Request Headers

Content-Type string Required

Enum: application/json

Authorization string Required

Bearer authentication token. Example: Bearer {{APIKey}}.

## Request Body

image string Required

The URL of the input image to be edited. It must be publicly accessible. Supported formats include JPG, JPEG, PNG, and WEBP.

prompt string Required

A natural language description of the desired edit. The model will modify the input image according to the prompt while preserving the original structure.

## Response

code integer

Returns 0 for success, or a specific error code.

message string

Returns "success" or a descriptive error message.

data object

taskId string

The unique identifier for the task. Use this ID with the Polling API to retrieve the edited image.

## Errors

10192parameter error; parameter validation failed

## Polling

Use the Polling API to retrieve the processing results.

## Callback

Alternatively, you can enable Callback to receive task results automatically upon completion.

### 0 Task Completed ```JSON { "code": 0, "message": "success", "data": { "images": [ { "imageType": "png", "imageUrl": "https://dreamapi-rs.newportai.com/dreamapi/o/2026-07-27/c7b80885a20f44b8a4266f2a1ab7594a.png" } ], "task": { "taskId": "API-65db579fa8f146ff82c73d5075fa7fcc", "status": 3, "errorCode": 0, "reason": "ok", "taskType": "gemma4_image_edit", "executionTime": 35054, "expire": 1785140144982, "creditsConsumed": 10 } } } ``` ### 0 Task Processing ```JSON { "code": 0, "message": "success", "data": { "task": { "taskId": "API-65db579fa8f146ff82c73d5075fa7fcc", "status": 2, "errorCode": 0, "reason": "ok", "taskType": "gemma4_image_edit", "expire": 1785140144982 } } } ``` ## Code Examples ```curl curl -X POST 'https://api.newportai.com/api/async/dreamimage_2.0' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer {{key}}' \ -d '{ "image": "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/INj5UrnnrKIzCR1uYBWv0.png", "prompt": "Replace the background with a beach sunset scene" }' ``` ```java HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://api.newportai.com/api/async/dreamimage_2.0")) .header("Content-Type", "application/json") .header("Authorization", "Bearer {{APIKey}}") .POST(HttpRequest.BodyPublishers.ofString("{\"image\":\"https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/INj5UrnnrKIzCR1uYBWv0.png\",\"prompt\":\"Replace the background with a beach sunset scene\"}")) .build(); HttpResponse res = client.send(request, HttpResponse.BodyHandlers.ofString()); ``` ```python import requests response = requests.post( "https://api.newportai.com/api/async/dreamimage_2.0", headers={ "Content-Type": "application/json", "Authorization": "Bearer {{APIKey}}" }, json={ "image": "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/INj5UrnnrKIzCR1uYBWv0.png", "prompt": "Replace the background with a beach sunset scene" } ) print(response.json()) ``` ## Response Example ### 0 Successful ```JSON { "code": 0, "message": "success", "data": { "taskId": "e4a8b3c1d2f94a5e8b7c6d5e4f3a2b1c" } } ``` ### 10192 Parameter error ```JSON { "code": 10192, "message": "parameter error;image is required and cannot be empty." } ``` ## --- TAB: Playground --- ## --- TAB: Pricing --- ## DreamImage 2.0 Billing Overview | Billing Mode | Credit Cost | | ------------ | ----------- | | Fixed | 10 credits | ## Credit Examples | Calling Model | Credits | | ------------- | ------- | | Per request | 10.0 | - [View Full Pricing Page](/pricing) - [Contact us](/contact)

DreamImage 2.0

Creation History