Skip to content
/V2.0

V2.0

With the AI Image Generator V2.0 API, you can instantly generate high-quality images from text prompts or existing images with improved visual, detail, and consistency.

Operations

Run an AI Image Generator task V2 for text to image.

Request

AI tasks are asynchronous. Prefer webhook-based completion handling when the feature supports webhooks. Configure your webhook endpoint, verify webhook signatures, and use the received task_id to query the task result after a success or error notification. See the webhook integration guide for setup and verification details.

If webhooks are not supported or cannot be used in your integration, implement polling. After submitting an AI task, poll the status endpoint at regular intervals (e.g., every 10 seconds) until the task status is success or error.

Security
BearerAuthenticationV2
Bodyapplication/jsonrequired
modelstringrequired

Model name.

Value:"youcam-image-v2"
promptstring, [ 1 .. 800 ] charactersrequired

A positive prompt describing the image content, style, and composition you want.
Supports Chinese and English. Maximum length is 800 characters. Each Chinese character, letter, digit, or symbol counts as one character.

Example:"A sitting orange cat with a joyful expression, lively and adorable, highly realistic."
negative_promptstring, [ 1 .. 500 ] characters

A negative prompt describing what you do not want in the image.
Supports Chinese and English. Maximum length is 500 characters.

Example:"Low resolution, low quality, distorted limbs, malformed fingers, oversaturated colors, wax-like appearance, no facial details, overly smooth surfaces
sizestring

Output image resolution, formatted as width*height.
Supported resolutions and their aspect ratios:
- 1664*928 (default): 16:9
- 1472*1104: 4:3
- 1328*1328: 1:1
- 1104*1472: 3:4
- 928*1664: 9:16

Default:"1664*928"
Enum:"1664*928""1472*1104""1328*1328""1104*1472""928*1664"
Example:"1664*928"
prompt_extendboolean

Enable smart prompt rewriting. The model optimizes the positive prompt. Does not affect the negative prompt.

Default:true
Enum ValueDescription
true

Enables rewriting. Use this for more diverse image content; the model adds details.

false

Disables rewriting. Use this for tighter control over image details.

Example:true
POST
/s2s/v2.0/task/text-to-image/youcam
curl -i -X POST \
  https://yce-api-01.makeupar.com/s2s/v2.0/task/text-to-image/youcam \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "youcam-image-v2",
    "prompt": "A sitting orange cat with a joyful expression, lively and adorable, highly realistic.",
    "negative_prompt": "Low resolution, low quality, distorted limbs, malformed fingers, oversaturated colors, wax-like appearance, no facial details, overly smooth surfaces, AI-generated look. Chaotic composition. Blurry or distorted text.",
    "size": "1664*928",
    "prompt_extend": true
  }'

Responses

Successful execution of the task

Bodyapplication/json
statusinteger

Response status

Example:200
dataobject
Response
{
  "status": 200,
  "data": {
    "task_id": "grH0CvsgXuAIHLUzD0V1Ol34hoet3R1tvdbtiVHrDb6_UqCLKIejAIajwxrhOAfe"
  }
}