OpenAI-Compatible
AI API Documentation

curl -X POST https://api.univence.com/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "model": "z-image-turbo",
    "prompt": "A beautiful sunset over mountains",
    "negative_prompt": "blurry, distorted, low quality",
    "image_size": "1024x1024",
    "seed": 12345,
    "num_inference_steps": 8
  }'

{
  "created": 1703123456,
  "data": [{ "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." }]
}

curl -X POST https://api.univence.com/v1/images/edits \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "model": "black-forest-labs/FLUX.2-klein-4B",
    "prompt": "Make the background tropical",
    "negative_prompt": "blurry, distorted, low quality",
    "input_images": ["iVBORw0KGgo...", "iVBORw0KGgo..."],
    "width": 1024, "height": 1024,
    "num_steps": 4, "guidance": 1.0, "seed": 12345,
    "match_image_size": 0
  }'

{
  "created": 1703123456,
  "data": [{ "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." }]
}

curl -X POST https://api.univence.com/v1/images/generations/batch \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "requests": [
      { "model": "z-image-turbo", "prompt": "A red sports car", "image_size": "512x512" },
      { "model": "z-image-turbo", "prompt": "A blue ocean wave", "image_size": "1024x1024" }
    ]
  }'

{
  "data": [
    { "created": 1703123456, "data": [{ "b64_json": "iVBORw0KGgo..." }] },
    { "created": 1703123457, "data": [{ "b64_json": "iVBORw0KGgoBB..." }] }
  ]
}

curl -X GET https://api.univence.com/v1/media/xyz789 -O output.png

curl -X POST https://api.univence.com/v1/images/segmentations \
  -H "X-API-Key: your-api-key" \
  -F "file=@image.jpg" \
  -F "prompt=segment person in image"

curl -X POST https://api.univence.com/v1/images/segmentations \
  -H "X-API-Key: your-api-key" \
  -F "file=@image.jpg" \
  -F 'point_coords=[[520,375],[100,200]]' \
  -F 'point_labels=[1,0]' \
  -F "multimask_output=true"

curl -X POST https://api.univence.com/v1/images/upscale \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "image": "iVBORw0KGgoAAAANSUhEUgAA...",
    "method": "realesrgan_4x"
  }'

{
  "created": 1703123456,
  "data": [{ "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..." }]
}

curl -X POST https://api.univence.com/v1/images/remove-background \
  -H "X-API-Key: your-api-key" \
  -F "file=@photo.jpg" \
  -F "prompt=person"

curl -X POST https://api.univence.com/v1/videos/remove-background \
  -H "X-API-Key: your-api-key" \
  -F "file=@video.mp4" \
  -F "prompt=person walking"

curl -X POST https://api.univence.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "messages": [
      { "role": "system", "content": "You are a helpful assistant." },
      { "role": "user", "content": "Hello, how are you?" }
    ],
    "temperature": 0.7,
    "max_tokens": 1000
  }'

curl -X POST https://api.univence.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "messages": [{
      "role": "user",
      "content": [
        { "type": "text", "text": "What is in this image?" },
        { "type": "image_url", "image_url": { "url": "data:image/png;base64,iVBORw0KGgo..." } }
      ]
    }],
    "max_tokens": 500
  }'

{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1703123456,
  "model": "Qwen/Qwen3.5-4B",
  "choices": [{
    "index": 0,
    "message": { "role": "assistant", "content": "Hello! How can I help you today?" },
    "finish_reason": "stop"
  }],
  "usage": { "prompt_tokens": 20, "completion_tokens": 15, "total_tokens": 35 }
}

curl -X POST https://api.univence.com/v1/audio/clone \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "text": "Hello, this is a test.",
    "ref_audio": "UklGRiQAAABXQVZFZm10IBAAAAABAAEAQB8AAEAfAAABAAgAZGF0YQAAAAA=",
    "ref_text": "Reference text here",
    "language": "English",
    "stream": false
  }' \
  --output cloned_voice.wav

curl -X POST https://api.univence.com/v1/music/generate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "prompt": "Energetic electronic dance music with heavy bass",
    "lyrics": "Pumping beats and flashing lights",
    "bpm": 128, "key_scale": "C Major", "time_signature": "4/4",
    "vocal_language": "en", "duration": 30, "instrumental": false,
    "audio_format": "wav"
  }' \
  --output generated_music.wav

curl -X POST https://api.univence.com/v1/images/img2video \
  -H "X-API-Key: your-api-key" \
  -F "image=@input_photo.jpg" \
  -F "prompt=a dramatic cinematic dolly zoom" \
  -F "negative_prompt=blurry, distorted" \
  -F "num_frames=81" -F "num_steps=4" -F "resolution=480p" -F "use_ode=false"

curl -X GET "https://api.univence.com/v1/images/user-videos?limit=20&offset=0&sortBy=newest&sortOrder=desc" \
  -H "X-API-Key: your-api-key"