Get 4o Image Details

GET 
https://kieai.erweima.ai/api/v1/gpt4o-image/record-info

Query 4o Image generation task details using taskId, including generation status, parameters and results.

Status Descriptions

• GENERATING: Generating in progress
• SUCCESS: Generation successful
• CREATE_TASK_FAILED: Failed to create task
• GENERATE_FAILED: Generation failed

Important Notes

• Maximum query rate is 3 times per second per task

Request

Query Parameters

taskId stringrequired
Unique identifier of the 4o image generation task
Example: task12345

Responses

200

Request successful

application/json

Schema

Schema

codeStatusCode (integer)
Response status code
Enum Value	Description
200	Success - Request has been processed successfully
401	Unauthorized - Authentication credentials are missing or invalid
402	Insufficient Credits - Account does not have enough credits to perform the operation
404	Not Found - The requested resource or endpoint does not exist
422	Validation Error - The request parameters failed validation checks
429	Rate Limited - Request limit has been exceeded for this resource
455	Service Unavailable - System is currently undergoing maintenance
500	Server Error - An unexpected error occurred while processing the request
505	Feature Disabled - The requested feature is currently disabled
Possible values: [200, 401, 402, 404, 422, 429, 455, 500, 505]
msgstring
Error message when code != 200
Example: success
data object
taskIdstring
Unique identifier of the 4o image generation task
Example: task12345
paramJsonstring
Request parameters
Example: {"prompt":"A beautiful sunset over the mountains","size":"1:1","isEnhance":false}
completeTimeint64
Task completion time
Example: 1672574400000
response object
Final result
resultUrlsstring[]
List of generated image URLs
Example: ["https://example.com/result/image1.png"]
successFlagint32
Generation status flag
Example: 1
statusstring
Generation status text, possible values: GENERATING-In progress, SUCCESS-Successful, CREATE_TASK_FAILED-Task creation failed, GENERATE_FAILED-Generation failed
Possible values: [GENERATING, SUCCESS, CREATE_TASK_FAILED, GENERATE_FAILED]
Example: SUCCESS
errorCodeint32
Error code
Enum Value	Description
400	Content Violation - The image content in filesUrl violates content policy
451	Download Failed - Unable to download image from the provided filesUrl
Possible values: [400, 451]
errorMessagestring
Error message
Example:
createTimeint64
Creation time
Example: 1672561200000
progressstring
Progress, minimum value is "0.00", maximum value is "1.00"
Example: 1.00

Example (auto)

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task12345",
    "paramJson": "{\"prompt\":\"A beautiful sunset over the mountains\",\"size\":\"1:1\",\"isEnhance\":false}",
    "completeTime": 1672574400000,
    "response": {
      "resultUrls": [
        "https://example.com/result/image1.png"
      ]
    },
    "successFlag": 1,
    "status": "SUCCESS",
    "errorCode": 400,
    "errorMessage": "",
    "createTime": 1672561200000,
    "progress": "1.00"
  }
}

Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "task12345",
    "paramJson": "{\"prompt\":\"A beautiful sunset over the mountains\",\"size\":\"1:1\",\"isEnhance\":false}",
    "completeTime": 1672574400000,
    "response": {
      "resultUrls": [
        "https://example.com/result/image1.png"
      ]
    },
    "successFlag": 1,
    "status": "SUCCESS",
    "errorCode": null,
    "errorMessage": "",
    "createTime": 1672561200000,
    "progress": "1.00"
  }
}

500

Server Error

Authorization: http

name: BearerAuthtype: httpscheme: bearerbearerFormat: API Keydescription: All APIs require authentication via Bearer Token.

Get API Key:
1. Visit [API Key Management Page](https://kie.ai/api-key) to get your API Key

Usage:
Add to request header:
Authorization: Bearer YOUR_API_KEY

Note:
- Keep your API Key secure and do not share it with others
- If you suspect your API Key has been compromised, reset it immediately in the management page

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://kieai.erweima.ai/api/v1/gpt4o-image/record-info");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://kieai.erweima.ai

Auth

Bearer Token

Parameters

taskId — queryrequired

ResponseClear

Click the Send API Request button above and see the response here!