Ovis Image: Precise Text-to-Image Generation Playground & API | RunComfy
aidc-ai/ovis-image
A powerful text-to-image model by AIDC-AI that delivers superior prompt adherence and realistic visual synthesis for professional content creation.
Table of contents
1. Get started
Use RunComfy's API to run aidc-ai/ovis-image. For accepted inputs and outputs, see the model's schema.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/aidc-ai/ovis-image \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A casually captured spontaneous iPhone photograph featuring an individual standing relaxed with arms gently crossed on a lightly grassy alpine slope beside rugged rocky formations. The subject wears a burgundy windbreaker jacket with an Arc'teryx logo, elastic cuffs, and a full-length zipper, crafted from durable water-resistant fabric realistically creased and subtly weathered with slight dirt marks. Loose, khaki cargo pants provide a comfortable fit, textured with natural creases and faint soil traces near the hems. Chunky dark gray sneakers with thick soles add a modern technical vibe. The jacket hood is casually pulled up, slightly shadowing their neutral, slightly obscured face, while sleek realistic sunglasses reflect the soft diffused mountain light. Ambient natural daylight is slightly overcast, casting gentle shadows on the uneven terrain of grassy wildflowers and rugged rocks. The framing holds a casual, slightly tilted angle, enhancing the authentic spontaneity and candid intimacy typical of trendy outdoor gorpcore iPhone photography. The background showcases distant jagged mountain ridges partially veiled in mist and low-hanging cloud layers, emphasizing pristine alpine wilderness and rugged outdoor adventure stylistics. Textural authenticity is prioritized with visible fabric textures, subtle weathering of shoes, natural grass details, and reflective sunglass lenses, reinforcing a highly believable, stylish technical outdoor aesthetic."
}'2. Authentication
Set the YOUR_API_TOKEN environment variable with your API key (manage keys in your Profile) and include it on every request as a Bearer token via the Authorization header: Authorization: Bearer $YOUR_API_TOKEN.
3. API reference
Submit a request
Submit an asynchronous generation job and immediately receive a request_id plus URLs to check status, fetch results, and cancel.
curl --request POST \
--url https://model-api.runcomfy.net/v1/models/aidc-ai/ovis-image \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <token>" \
--data '{
"prompt": "A casually captured spontaneous iPhone photograph featuring an individual standing relaxed with arms gently crossed on a lightly grassy alpine slope beside rugged rocky formations. The subject wears a burgundy windbreaker jacket with an Arc'teryx logo, elastic cuffs, and a full-length zipper, crafted from durable water-resistant fabric realistically creased and subtly weathered with slight dirt marks. Loose, khaki cargo pants provide a comfortable fit, textured with natural creases and faint soil traces near the hems. Chunky dark gray sneakers with thick soles add a modern technical vibe. The jacket hood is casually pulled up, slightly shadowing their neutral, slightly obscured face, while sleek realistic sunglasses reflect the soft diffused mountain light. Ambient natural daylight is slightly overcast, casting gentle shadows on the uneven terrain of grassy wildflowers and rugged rocks. The framing holds a casual, slightly tilted angle, enhancing the authentic spontaneity and candid intimacy typical of trendy outdoor gorpcore iPhone photography. The background showcases distant jagged mountain ridges partially veiled in mist and low-hanging cloud layers, emphasizing pristine alpine wilderness and rugged outdoor adventure stylistics. Textural authenticity is prioritized with visible fabric textures, subtle weathering of shoes, natural grass details, and reflective sunglass lenses, reinforcing a highly believable, stylish technical outdoor aesthetic."
}'Monitor request status
Fetch the current state for a request_id ("in_queue", "in_progress", "completed", or "cancelled").
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"Retrieve request results
Retrieve the final outputs and metadata for the given request_id; if the job is not complete, the response returns the current state so you can continue polling.
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"Cancel a request
Cancel a queued job by request_id, in-progress jobs cannot be cancelled.
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"4. File inputs
Hosted file (URL)
Provide a publicly reachable HTTPS URL. Ensure the host allows server‑side fetches (no login/cookies required) and isn't rate‑limited or blocking bots. Recommended limits: images ≤ 50 MB (~4K), videos ≤ 100 MB (~2–5 min @ 720p). Prefer stable or pre‑signed URLs for private assets.
5. Schema
Input schema
{
"type": "object",
"title": "Input",
"required": [
"prompt"
],
"properties": {
"prompt": {
"title": "Prompt",
"description": "",
"type": "string",
"default": "A casually captured spontaneous iPhone photograph featuring an individual standing relaxed with arms gently crossed on a lightly grassy alpine slope beside rugged rocky formations. The subject wears a burgundy windbreaker jacket with an Arc'teryx logo, elastic cuffs, and a full-length zipper, crafted from durable water-resistant fabric realistically creased and subtly weathered with slight dirt marks. Loose, khaki cargo pants provide a comfortable fit, textured with natural creases and faint soil traces near the hems. Chunky dark gray sneakers with thick soles add a modern technical vibe. The jacket hood is casually pulled up, slightly shadowing their neutral, slightly obscured face, while sleek realistic sunglasses reflect the soft diffused mountain light. Ambient natural daylight is slightly overcast, casting gentle shadows on the uneven terrain of grassy wildflowers and rugged rocks. The framing holds a casual, slightly tilted angle, enhancing the authentic spontaneity and candid intimacy typical of trendy outdoor gorpcore iPhone photography. The background showcases distant jagged mountain ridges partially veiled in mist and low-hanging cloud layers, emphasizing pristine alpine wilderness and rugged outdoor adventure stylistics. Textural authenticity is prioritized with visible fabric textures, subtle weathering of shoes, natural grass details, and reflective sunglass lenses, reinforcing a highly believable, stylish technical outdoor aesthetic."
},
"negative_prompt": {
"title": "Negative Prompt",
"description": "",
"type": "string",
"default": ""
},
"image_size": {
"title": "Image Size",
"description": "",
"type": "string",
"enum": [
"square_hd",
"square",
"portrait_4_3",
"portrait_16_9",
"landscape_4_3",
"landscape_16_9"
],
"default": "landscape_4_3"
},
"num_inference_steps": {
"title": "Number of Inference Steps",
"description": "The number of inference steps to perform.",
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 28
},
"guidance_scale": {
"title": "Guidance Scale",
"description": "The guidance scale to use for the image generation.",
"type": "float",
"minimum": 1,
"maximum": 20,
"default": 5
},
"seed": {
"title": "Seed",
"description": "",
"type": "integer",
"default": null
},
"output_format": {
"title": "Output Format",
"description": "The format of the generated image.",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
],
"default": "png"
}
}
}Output schema
{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "single image URL"
},
"video": {
"type": "string",
"format": "uri",
"description": "single video URL"
},
"images": {
"type": "array",
"description": "multiple image URLs",
"items": { "type": "string", "format": "uri" }
},
"videos": {
"type": "array",
"description": "multiple video URLs",
"items": { "type": "string", "format": "uri" }
}
}
}
}