使用 RunComfy 的 API 執行 aidc-ai/ovis-image。 可接受的輸入與輸出請參閱模型的 資料結構說明。
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."
}'將 YOUR_API_TOKEN 環境變數設為您的 API 金鑰(在 個人資料中管理金鑰),並在每個請求的 Authorization 標頭中以 Bearer 權杖形式攜帶: Authorization: Bearer $YOUR_API_TOKEN。
提交非同步生成工作後,將立即取得 request_id 以及用於查詢狀態、取得結果與取消的 URL。
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."
}'依 request_id 取得目前狀態(「in_queue」、「in_progress」、「completed」或「cancelled」)。
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/status \
--header "Authorization: Bearer <token>"取得指定 request_id 的最終輸出與中繼資料;若工作尚未完成,回應會回傳目前狀態,方便繼續輪詢。
curl --request GET \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/result \
--header "Authorization: Bearer <token>"透過 request_id 取消排隊中的工作;進行中的工作無法取消。
curl --request POST \
--url https://model-api.runcomfy.net/v1/requests/{request_id}/cancel \
--header "Authorization: Bearer <token>"請提供可公開存取的 HTTPS 位址。確保目標主機允許伺服器端抓取(無需登入或 Cookie)、未被限流或阻擋機器人。建議:圖片 ≤ 50 MB(約 4K),影片 ≤ 100 MB(約 720p 下 2–5 分鐘)。私人資產請使用穩定或預先簽署 URL。
{
"type": "object",
"title": "輸入結構",
"required": [
"prompt"
],
"properties": {
"prompt": {
"title": "提示詞",
"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": "負面提示詞",
"description": "",
"type": "string",
"default": ""
},
"image_size": {
"title": "圖片尺寸",
"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": "推論步數",
"description": "推論步數,範圍為 1–50。",
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 28
},
"guidance_scale": {
"title": "引導強度",
"description": "控制生成結果遵循提示詞的強度,範圍為 1–20。",
"type": "float",
"minimum": 1,
"maximum": 20,
"default": 5
},
"seed": {
"title": "隨機種子",
"description": "",
"type": "integer",
"default": null
},
"output_format": {
"title": "輸出格式",
"description": "生成圖片的檔案格式。",
"type": "string",
"enum": [
"jpeg",
"png",
"webp"
],
"default": "png"
}
}
}{
"output": {
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "uri",
"description": "單張圖片 URL"
},
"video": {
"type": "string",
"format": "uri",
"description": "單一影片 URL"
},
"images": {
"type": "array",
"description": "多張圖片 URL",
"items": {
"type": "string",
"format": "uri"
}
},
"videos": {
"type": "array",
"description": "多個影片 URL",
"items": {
"type": "string",
"format": "uri"
}
}
}
}
}RunComfy 是首選的 ComfyUI 平台,提供 ComfyUI 在線 環境和服務,以及 ComfyUI 工作流程 具有驚豔的視覺效果。 RunComfy還提供 AI Models, 幫助藝術家利用最新的AI工具創作出令人驚艷的藝術作品。