curl --request POST \ --url http://localhost:8000/v1/images/generations \ --header 'Content-Type: application/json' \ --data '{ "prompt": "An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background."}'
import requests
url = "http://localhost:8000/v1/images/generations"
payload = { "prompt": "An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background." }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
prompt: 'An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background.'
})
};
fetch('http://localhost:8000/v1/images/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://localhost:8000/v1/images/generations"
payload := strings.NewReader("{\n \"prompt\": \"An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background.\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
{ "image": "<base64 encoded image>"}
Inference
Container Image Generations
Generate an image from a text prompt.
POST
/
v1
/
images
/
generations
Image generations
curl --request POST \ --url http://localhost:8000/v1/images/generations \ --header 'Content-Type: application/json' \ --data '{ "prompt": "An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background."}'
import requests
url = "http://localhost:8000/v1/images/generations"
payload = { "prompt": "An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background." }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)
const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
prompt: 'An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background.'
})
};
fetch('http://localhost:8000/v1/images/generations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "http://localhost:8000/v1/images/generations"
payload := strings.NewReader("{\n \"prompt\": \"An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background.\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
{ "image": "<base64 encoded image>"}
Generate an image from a text prompt.
Body
application/json
prompt
string
required
A text description of the desired image.
model
string | null
Routes the request to a specific adapter.
Example:
"(adapter-route)"
num_inference_steps
integer
default:20
The number of inference steps to use during image generation. Defaults to 20. Supported range: [1, 50].
guidance_scale
number
default:0
Adjusts the alignment of the generated image with the input prompt. Higher values (e.g., 8-10) make the output more faithful to the prompt, while lower values (e.g., 1-5) encourage more creative freedom. Defaults to 0. This parameter may be irrelevant for certain models, such as FLUX.Schnell.
seed
integer | null
The seed to use for image generation.
response_format
enum<string> | null
default:jpeg
The format in which the generated image will be returned. One of raw and jpeg.
Available options:
raw,
jpeg
control_images
ImageInput · object[] | null
Optional input images used to condition or guide the generation process (e.g., for ControlNet or image editing models). This field is only applicable when using ControlNet or image editing models.
Hide child attributes
control_images.image
string
required
An input image, provided either as a URL or a base64-encoded string. Maximum supported image size is 50 MiB.
A list of weights that determine the influence of each ControlNet model in the generation process. Each value must be within [0, 1], where 0 disables the corresponding ControlNet and 1 applies it fully. When multiple ControlNet models are used, the list length must match the number of control images. If omitted, all ControlNet models default to full influence (1.0). This field is only applicable when using ControlNet models.
Response
Successfully generated image.
image
file
required
The base64-encoded image.
Last modified on June 9, 2026
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"FriendliAI Docs","description":"Let your team focus on building great AI products. FriendliAI will make sure your AI runs fast, affordable, and reliable at scale. Leave the hassle of AI inference to FriendliAI.","colors":{"primary":"#2A62DB","light":"#4f87ff","dark":"#1e469b"},"logo":{"light":"https://mintcdn.com/friendliai/Xn-EfFlXFvptInk9/static/svgs/logo.svg?fit=max\u0026auto=format\u0026n=Xn-EfFlXFvptInk9\u0026q=85\u0026s=0a04a5dd2152a1258e6d3ce995b70eb0","dark":"https://mintcdn.com/friendliai/OmGyXdVnt91Gfn8z/static/svgs/logo-dark.svg?fit=max\u0026auto=format\u0026n=OmGyXdVnt91Gfn8z\u0026q=85\u0026s=7bc2b761b9c8da66973a9869b7de4f90"},"favicon":"https://mintcdn.com/friendliai/Xn-EfFlXFvptInk9/static/svgs/favicon.svg?fit=max\u0026auto=format\u0026n=Xn-EfFlXFvptInk9\u0026q=85\u0026s=d425e1903adeb917593a54eb3d20c66b","api":{"openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml","params":{"expanded":"all"},"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","python","javascript","go"],"prefill":true,"autogenerate":true}},"background":{"color":{"light":"#FFFFFF","dark":"#0A101A"}},"navbar":{"primary":{"type":"button","label":"Dashboard","href":"https://friendli.ai/get-started/dedicated-endpoints"}},"footer":{"socials":{"website":"https://friendli.ai","linkedin":"https://www.linkedin.com/company/friendliai","youtube":"https://www.youtube.com/@friendliai","github":"https://github.com/friendliai","discord":"https://discord.gg/g53ByexhR","x":"https://x.com/friendliai","medium":"https://medium.com/friendliai","facebook":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","slack":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","instagram":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","hacker-news":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","telegram":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","twitter":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","x-twitter":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","earth-americas":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","bluesky":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","threads":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","reddit":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css","podcast":"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css"}},"search":{"prompt":"Search FriendliAI Docs..."},"seo":{"metatags":{"og:site_name":"FriendliAI Docs","twitter:card":"summary_large_image"}},"integrations":{"gtm":{"tagId":"GTM-MVXVF29V"},"telemetry":{"enabled":true}},"banner":{"content":"Try [GLM-5.3](https://friendli.ai/models/zai-org/GLM-5.3) and [GLM-5.3-Flash](https://friendli.ai/models/zai-org/GLM-5.3-Flash) today. To learn more, see the [FriendliAI Blog](https://friendli.ai/blog)."},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"metadata":{"timestamp":true},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Home","icon":"home","href":"https://friendli.ai"},{"anchor":"Models","icon":"brain","href":"https://friendli.ai/models"},{"anchor":"Pricing","icon":"tag","href":"https://friendli.ai/pricing"},{"anchor":"Blog","icon":"newspaper","href":"https://friendli.ai/blog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"friendliai","hasAudioNarration":false,"actualSubdomain":"friendliai","customDomains":["friendli.ai"],"gitSource":{"type":"github","owner":"friendliai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6affa52095a415ad176e2a10","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Guides","count":45},{"language":"default","tag":"Examples","count":40},{"language":"default","tag":"Reference","count":36},{"language":"default","tag":"Inference","count":30},{"language":"default","tag":"Archive","count":24},{"language":"default","tag":"Dedicated","count":24},{"language":"default","tag":"Friendli Container","count":23},{"language":"default","tag":"Agents","count":14},{"language":"default","tag":"Friendli Dedicated Endpoints","count":12},{"language":"default","tag":"API Reference","count":12}]},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"email":"support@friendli.ai","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5Z5ClqOw.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5Q5ClqOw.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* symbols2 */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK7uxQxXAuk.woff2) format('woff2');\n unicode-range: U+2000-2001, U+2004-2008, U+200A, U+23B8-23BD, U+2500-259F;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5b5ClqOw.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5a5ClqOw.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Geist Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/docs/_mintlify/assets/fonts/google/s/geistmono/v6/or3yQ6H-1_WfwkMZI_qYPLs1a-t7PU0AbeE9KK5U5Ck.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n@font-face{font-family:\"Saans-Light\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Light.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Light.woff\") format(\"woff\");font-weight:300;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-Regular\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Regular.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Regular.woff\")\n\t\tformat(\"woff\");font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-Medium\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Medium.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Medium.woff\")\n\t\tformat(\"woff\");font-weight:500;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-SemiBold\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-SemiBold.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-SemiBold.woff\")\n\t\tformat(\"woff\");font-weight:600;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-Bold\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Bold.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Bold.woff\") format(\"woff\");font-weight:700;font-style:normal;font-display:swap}@font-face{font-family:\"Saans-Heavy\";src:url(\"https://docs-assets.friendli.ai/fonts/Saans-Heavy.woff2\")\n\t\tformat(\"woff2\"),\n\t\turl(\"https://docs-assets.friendli.ai/fonts/Saans-Heavy.woff\") format(\"woff\");font-weight:800;font-style:normal;font-display:swap}:root{--gray-300: 159 179 200;--primary-accent: #0095ff}.border-gray-100{border-color:#d9e2ec}body{font-family:\"Saans-Regular\", sans-serif;letter-spacing:0.01em}.tracking-tighter{letter-spacing:-0.04em}.tracking-tight{letter-spacing:0.01em}.tracking-normal{letter-spacing:0.01em}.tracking-wide{letter-spacing:0.01em}.tracking-wider{letter-spacing:0.05em}.tracking-widest{letter-spacing:0.1em}.prose :where(h1,h2,h3):not(:where([class~=\"not-prose\"],[class~=\"not-prose\"] *)){letter-spacing:0}.font-medium:not(.font-mono):not(.font-mono *),.mint-font-medium:not(.font-mono):not(.font-mono *){font-family:\"Saans-Medium\", sans-serif}h1:not(.font-mono):not(.font-mono *),h2:not(.font-mono):not(.font-mono *),h3:not(.font-mono):not(.font-mono *),h4:not(.font-mono):not(.font-mono *),h5:not(.font-mono):not(.font-mono *),strong:not(.font-mono):not(.font-mono *),.font-semibold:not(.font-mono):not(.font-mono *),.mint-font-semibold:not(.font-mono):not(.font-mono *),.prose :where(a):not(:where([class~=\"not-prose\"],[class~=\"not-prose\"] *)):not(.font-mono):not(.font-mono *){font-family:\"Saans-SemiBold\", sans-serif}.prose :is(p,li,td,dd) svg.icon{vertical-align:-0.025em!important}.prose :is(p,li,td,dd) a[href^=\"http\"]:not([href*=\"friendli.ai\"]):not(:has(img))::after{content:\"\";display:inline-block;width:0.7em;height:0.7em;margin-left:0.2em;vertical-align:-0.05em;background-color:currentColor;-webkit-mask:url(\"data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20512%20512%22%3E%3Cpath%20d%3D%22M320%200c-17.7%200-32%2014.3-32%2032s14.3%2032%2032%2032l82.7%200-201.4%20201.4c-12.5%2012.5-12.5%2032.8%200%2045.3s32.8%2012.5%2045.3%200L448%20109.3%20448%20192c0%2017.7%2014.3%2032%2032%2032s32-14.3%2032-32l0-160c0-17.7-14.3-32-32-32L320%200zM80%2096C35.8%2096%200%20131.8%200%20176L0%20432c0%2044.2%2035.8%2080%2080%2080l256%200c44.2%200%2080-35.8%2080-80l0-80c0-17.7-14.3-32-32-32s-32%2014.3-32%2032l0%2080c0%208.8-7.2%2016-16%2016L80%20448c-8.8%200-16-7.2-16-16l0-256c0-8.8%207.2-16%2016-16l80%200c17.7%200%2032-14.3%2032-32s-14.3-32-32-32L80%2096z%22%2F%3E%3C%2Fsvg%3E\")\n\t\tno-repeat center / contain;mask:url(\"data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20viewBox%3D%220%200%20512%20512%22%3E%3Cpath%20d%3D%22M320%200c-17.7%200-32%2014.3-32%2032s14.3%2032%2032%2032l82.7%200-201.4%20201.4c-12.5%2012.5-12.5%2032.8%200%2045.3s32.8%2012.5%2045.3%200L448%20109.3%20448%20192c0%2017.7%2014.3%2032%2032%2032s32-14.3%2032-32l0-160c0-17.7-14.3-32-32-32L320%200zM80%2096C35.8%2096%200%20131.8%200%20176L0%20432c0%2044.2%2035.8%2080%2080%2080l256%200c44.2%200%2080-35.8%2080-80l0-80c0-17.7-14.3-32-32-32s-32%2014.3-32%2032l0%2080c0%208.8-7.2%2016-16%2016L80%20448c-8.8%200-16-7.2-16-16l0-256c0-8.8%207.2-16%2016-16l80%200c17.7%200%2032-14.3%2032-32s-14.3-32-32-32L80%2096z%22%2F%3E%3C%2Fsvg%3E\")\n\t\tno-repeat center / contain}code:not(.font-mono *),pre,kbd,.font-mono{font-family:\"Geist Mono\", ui-monospace, SFMono-Regular, Menlo, Monaco, monospace}#banner{background-color:var(--primary-accent);font-size:16px;box-shadow:none}#banner>div{margin-top:0.625rem;margin-bottom:0.625rem;p {\n\t\tcolor: #ffffff;\n\t}\n\n\ta {\n\t\tcolor: #ffffff;\n\t\tfont-weight: 600;\n\t\ttext-decoration: underline;\n\t\tpadding-left: 0.25rem;\n\t}}#topbar-cta-button,#topbar-cta-button a,#topbar-cta-button.bg-primary-dark,#topbar-cta-button .bg-primary-dark{background-color:#2a62db!important;color:#ffffff!important;border:none!important;border-radius:6px;box-shadow:none!important}#topbar-cta-button:hover,#topbar-cta-button:hover a,#topbar-cta-button:hover .bg-primary-dark,#topbar-cta-button a:hover,#topbar-cta-button a:hover .bg-primary-dark,#topbar-cta-button.bg-primary-dark:hover,#topbar-cta-button .bg-primary-dark:hover{background-color:#1a4ec4!important}#topbar-cta-button>.font-medium,#topbar-cta-button>.mint-font-medium{font-family:\"Saans-Medium\", sans-serif}#header>div:not(:first-child){display:none}.card>div>div:last-child>div{margin-top:0.5rem}.card [data-component-part=\"card-content\"]{font-family:\"Saans-Regular\", sans-serif}.card-group.columns{gap:1rem}.rounded-border-box{padding:28px 44px;border:1px solid #d9e2ec;border-radius:8px;overflow:hidden;img {\n\t\tmargin: 0 auto;\n\t\tborder: 1px solid #e7eef4;\n\t\tborder-radius: 8px;\n\t}\n\n\tp {\n\t\tmargin: 12px auto -12px;\n\t\ttext-align: center;\n\t\tword-break: break-all;\n\t}}.dark .rounded-border-box{border:1px solid #243b53}.dark .rounded-border-box img{border:1px solid #212832}html[data-current-path=\"/\"] .nav-tabs-item[data-active]{text-shadow:none}html[data-current-path=\"/\"] .nav-tabs-item[data-active]>div{display:none}html[data-current-path=\"/\"] #content-container{max-width:none;padding-inline:1rem}html[data-current-path=\"/\"] #header{display:none}html[data-current-path=\"/\"] #content{margin-top:0}#footer [href=\"https://friendli.ai/?unused-social-placeholder-required-by-zod-4-hidden-by-css\"]{display:none}"}]}
{"page":{"pagePath":"openapi/container/image-generations","slug":"/openapi/container/image-generations","pageMetadata":{"title":"Container Image Generations","description":"Generate an image from a text prompt.","deprecated":null,"version":null,"sidebarTitle":"Image Generations","og:title":"Container Image Generations","og:description":"Generate an image from a text prompt.","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/images/generations","href":"/openapi/container/image-generations","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Generate an image from a text prompt.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components};return _jsx(_components.p,{children:`Generate an image from a text prompt.`})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Container Image Generations","description":"Generate an image from a text prompt.","deprecated":null,"version":null,"sidebarTitle":"Image Generations","og:title":"Container Image Generations","og:description":"Generate an image from a text prompt.","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/images/generations","href":"/openapi/container/image-generations","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/friendliai/13360a4393f88fc7/script.js"],"openApiReferenceData":{"operation":{"tags":["Container.Image"],"summary":"Image generations","description":"Generate an image from a text prompt.","operationId":"containerImagesGenerate","requestBody":"f1721933-157f-4872-a40c-1b19ca8a308d","responses":{"200":"bed04a3c-5f5c-45d2-b5cf-aabd76c54acf","422":"70700598-8bed-4e5f-acad-b4dc624215cd"},"x-speakeasy-name-override":"generate","x-mint":{"metadata":{"title":"Container Image Generations","sidebarTitle":"Image Generations","og:title":"Container Image Generations","description":"Generate an image from a text prompt.","og:description":"Generate an image from a text prompt."},"href":"/openapi/container/image-generations","content":"Generate an image from a text prompt."},"method":"post","type":"path","servers":["2eecd816-b8ac-469d-ba5f-23f5f3d9b3ab"],"security":[],"path":"/v1/images/generations","baseUrlOptions":["http://localhost:8000"],"title":"Image generations","codeSamples":[],"requestExampleLanguages":["bash","python","javascript","go"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.prompt":"An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background.","body.num_inference_steps":10,"body.guidance_scale":3.5}]},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"properties":{"prompt":{"type":"string","title":"Prompt","description":"A text description of the desired image.","isRequired":true,"uniqueKey":"prompt","typeLabel":"string"},"model":{"oneOf":[{"type":"string","title":"Model","description":"Routes the request to a specific adapter.","example":"(adapter-route)","uniqueKey":"model.oneOf.0","typeLabel":"string"},{"type":"null","title":"Model","description":"Routes the request to a specific adapter.","example":"(adapter-route)","uniqueKey":"model.oneOf.1","typeLabel":"null"}],"uniqueKey":"model","typeLabel":"string | null"},"num_inference_steps":{"type":"integer","title":"Num Inference Steps","description":"The number of inference steps to use during image generation. Defaults to 20. Supported range: [1, 50].","default":20,"uniqueKey":"num_inference_steps","typeLabel":"integer"},"guidance_scale":{"type":"number","title":"Guidance Scale","description":"Adjusts the alignment of the generated image with the input prompt. Higher values (e.g., 8-10) make the output more faithful to the prompt, while lower values (e.g., 1-5) encourage more creative freedom. Defaults to 0. This parameter may be irrelevant for certain models, such as `FLUX.Schnell`.","default":0,"uniqueKey":"guidance_scale","typeLabel":"number"},"seed":{"oneOf":[{"type":"integer","title":"Seed","description":"The seed to use for image generation.","uniqueKey":"seed.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Seed","description":"The seed to use for image generation.","uniqueKey":"seed.oneOf.1","typeLabel":"null"}],"uniqueKey":"seed","typeLabel":"integer | null"},"response_format":{"oneOf":[{"type":"string","title":"Response Format","description":"The format in which the generated image will be returned. One of `raw` and `jpeg`.","default":"jpeg","enum":["raw","jpeg"],"uniqueKey":"response_format.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","title":"Response Format","description":"The format in which the generated image will be returned. One of `raw` and `jpeg`.","default":"jpeg","uniqueKey":"response_format.oneOf.1","typeLabel":"null"}],"uniqueKey":"response_format","typeLabel":"enum\u003cstring> | null"},"control_images":{"oneOf":[{"type":"array","items":{"properties":{"image":{"type":"string","title":"Image","description":"An input image, provided either as a URL or a base64-encoded string. Maximum supported image size is 50 MiB.","examples":["https://huggingface.co/datasets/huggingface/documentation-images/resolve/main/diffusers/cat.png","data:image/png;base64,..."],"isRequired":true,"uniqueKey":"control_images.oneOf.0.items.[INDEX].image","typeLabel":"string"}},"type":"object","required":["image"],"title":"ImageInput","uniqueKey":"control_images.oneOf.0.items.[INDEX]","typeLabel":"ImageInput · object"},"title":"Control Images","description":"Optional input images used to condition or guide the generation process (e.g., for ControlNet or image editing models). This field is only applicable when using ControlNet or image editing models.","uniqueKey":"control_images.oneOf.0","typeLabel":"ImageInput · object[]"},{"type":"null","title":"Control Images","description":"Optional input images used to condition or guide the generation process (e.g., for ControlNet or image editing models). This field is only applicable when using ControlNet or image editing models.","uniqueKey":"control_images.oneOf.1","typeLabel":"null"}],"uniqueKey":"control_images","typeLabel":"ImageInput · object[] | null"},"controlnet_weights":{"oneOf":[{"type":"array","items":{"type":"number","uniqueKey":"controlnet_weights.oneOf.0.items.[INDEX]","typeLabel":"number"},"title":"Controlnet Weights","description":"A list of weights that determine the influence of each ControlNet model in the generation process. Each value must be within [0, 1], where 0 disables the corresponding ControlNet and 1 applies it fully. When multiple ControlNet models are used, the list length must match the number of control images. If omitted, all ControlNet models default to full influence (1.0). This field is only applicable when using ControlNet models.","uniqueKey":"controlnet_weights.oneOf.0","typeLabel":"number[]"},{"type":"null","title":"Controlnet Weights","description":"A list of weights that determine the influence of each ControlNet model in the generation process. Each value must be within [0, 1], where 0 disables the corresponding ControlNet and 1 applies it fully. When multiple ControlNet models are used, the list length must match the number of control images. If omitted, all ControlNet models default to full influence (1.0). This field is only applicable when using ControlNet models.","uniqueKey":"controlnet_weights.oneOf.1","typeLabel":"null"}],"uniqueKey":"controlnet_weights","typeLabel":"number[] | null"}},"type":"object","required":["prompt"],"title":"ContainerImageGenerationBody","example":{"guidance_scale":3.5,"num_inference_steps":10,"prompt":"An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background."},"uniqueKey":"","typeLabel":"ContainerImageGenerationBody · object"},"examples":{"Example":{"title":"Example","value":{"guidance_scale":3.5,"num_inference_steps":10,"prompt":"An orange Lamborghini driving down a hill road at night with a beautiful ocean view in the background."}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"bed04a3c-5f5c-45d2-b5cf-aabd76c54acf":{"description":"Successfully generated image.","content":{"application/json":{"schema":{"properties":{"image":{"type":"string","format":"binary","title":"Image","description":"The base64-encoded image.","isRequired":true,"uniqueKey":"image","typeLabel":"file"}},"type":"object","required":["image"],"title":"ContainerImageGenerateSuccess","uniqueKey":"","typeLabel":"ContainerImageGenerateSuccess · object"},"examples":{"Example":{"title":"Example","value":{"image":"\u003cbase64 encoded image>"}}},"exampleType":"examples"}},"exampleType":"examples"},"70700598-8bed-4e5f-acad-b4dc624215cd":{"description":"Unprocessable Entity","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{},"servers":{"2eecd816-b8ac-469d-ba5f-23f5f3d9b3ab":{"url":"http://localhost:8000"}}},"originalFileLocation":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml"},"subdomain":"friendliai","siteName":"FriendliAI Docs","title":"Container Image Generations","contextualStarterQuestions":[{"_id":"69fd749368c9a4a0bb4ed147","deploymentId":"66d1620afd71f66abaace95b","questionText":"Can I customize image size?","status":"active","generatedBy":"contextual","path":"openapi/container/image-generations","createdAt":"2026-05-08T05:28:51.978Z","updatedAt":"2026-05-08T05:28:51.978Z","__v":0},{"_id":"69fd749368c9a4a0bb4ed145","deploymentId":"66d1620afd71f66abaace95b","questionText":"How do I generate images?","status":"active","generatedBy":"contextual","path":"openapi/container/image-generations","createdAt":"2026-05-08T05:28:51.978Z","updatedAt":"2026-05-08T05:28:51.978Z","__v":0},{"_id":"69fd749368c9a4a0bb4ed146","deploymentId":"66d1620afd71f66abaace95b","questionText":"What models are available?","status":"active","generatedBy":"contextual","path":"openapi/container/image-generations","createdAt":"2026-05-08T05:28:51.978Z","updatedAt":"2026-05-08T05:28:51.978Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T03:11:20.550Z","gitLastModified":"2026-06-09T01:14:16.000Z","originalFileLocation":"openapi/container/image-generations.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Generate an image from a text prompt.\">\u003cmeta data-mint-head name=\"application-name\" content=\"FriendliAI Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Container Image Generations\">\u003cmeta data-mint-head property=\"og:description\" content=\"Generate an image from a text prompt.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"FriendliAI Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://friendli.ai/docs/openapi/container/image-generations\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://friendliai.mintlify.site/docs/_mintlify/api/og/v2?division=Inference\u0026amp;title=Container+Image+Generations\u0026amp;description=Generate+an+image+from+a+text+prompt.\u0026amp;theme=dd6dd98f885ae143c6c3d0cf\u0026amp;signature=c5aac9de25a48d988ce8c2f92d2fadb57db4c4e15cb3b625cedab34eeb221e3d\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Container Image Generations\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Generate an image from a text prompt.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://friendliai.mintlify.site/docs/_mintlify/api/og/v2?division=Inference\u0026amp;title=Container+Image+Generations\u0026amp;description=Generate+an+image+from+a+text+prompt.\u0026amp;theme=dd6dd98f885ae143c6c3d0cf\u0026amp;signature=c5aac9de25a48d988ce8c2f92d2fadb57db4c4e15cb3b625cedab34eeb221e3d\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/friendliai/f_6Xi29vsyX4mJlf/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"FriendliAI Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2A62DB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://friendli.ai/docs/openapi/container/image-generations\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/openapi/container/image-generations.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://friendli.ai/#organization\",\"name\":\"FriendliAI Docs\",\"url\":\"https://friendli.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/friendliai/Xn-EfFlXFvptInk9/static/svgs/logo.svg?fit=max\u0026auto=format\u0026n=Xn-EfFlXFvptInk9\u0026q=85\u0026s=0a04a5dd2152a1258e6d3ce995b70eb0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://friendli.ai/docs#website\",\"name\":\"FriendliAI Docs\",\"url\":\"https://friendli.ai/docs\",\"publisher\":{\"@id\":\"https://friendli.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://friendli.ai/docs/openapi/container/image-generations#webpage\",\"url\":\"https://friendli.ai/docs/openapi/container/image-generations\",\"name\":\"Container Image Generations\",\"description\":\"Generate an image from a text prompt.\",\"dateModified\":\"2026-06-09T01:14:16.000Z\",\"isPartOf\":{\"@id\":\"https://friendli.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://friendli.ai/docs/openapi/container/image-generations#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://friendli.ai/docs/openapi/container/image-generations#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Friendli Container\",\"item\":\"https://friendli.ai/docs/archive/container/guides/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://friendli.ai/docs/openapi/container/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Inference\",\"item\":\"https://friendli.ai/docs/openapi/container/chat-completions\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Container Image Generations\",\"item\":\"https://friendli.ai/docs/openapi/container/image-generations\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://friendli.ai/docs/openapi/container/image-generations#apireference\",\"headline\":\"Container Image Generations\",\"name\":\"Container Image Generations\",\"description\":\"Generate an image from a text prompt.\",\"url\":\"https://friendli.ai/docs/openapi/container/image-generations\",\"mainEntityOfPage\":{\"@id\":\"https://friendli.ai/docs/openapi/container/image-generations#webpage\"},\"dateModified\":\"2026-06-09T01:14:16.000Z\",\"publisher\":{\"@id\":\"https://friendli.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://friendli.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"FriendliAI Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"FriendliAI Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/openapi/container/image-generations.md","siteName":"FriendliAI Docs","nav":{"global":{"anchors":[{"anchor":"Home","icon":"home","href":"https://friendli.ai"},{"anchor":"Models","icon":"brain","href":"https://friendli.ai/models"},{"anchor":"Pricing","icon":"tag","href":"https://friendli.ai/pricing"},{"anchor":"Blog","icon":"newspaper","href":"https://friendli.ai/blog"}]},"tabs":[{"tab":"Home","hidden":true,"searchable":true,"pages":[{"title":"Home","href":""}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/introduction/overview"}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/examples/models/overview"}]},{"tab":"Reference","pages":[{"title":"Reference","href":"/openapi/introduction"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]},{"tab":"Archive","hidden":true,"searchable":true,"groups":[{"group":"Friendli Container","pages":[{"group":"Guides","icon":"book-open","expanded":true,"pages":[{"title":"Introducing Friendli Container","sidebarTitle":"Introduction","description":"Deploy generative AI models on your own infrastructure with Friendli Container. Full control over GPU resources, networking, and scaling.","href":"/archive/container/guides/introduction"},{"title":"QuickStart: Friendli Container Trial","sidebarTitle":"QuickStart","description":"Get started with Friendli Container trial. Access the registry, configure your secret, launch the container, and monitor with Grafana.","href":"/archive/container/guides/quickstart"},{"title":"Configuration","sidebarTitle":"Configuration","description":"Configuration reference for Friendli Container: how to pass launch options, serve across multiple GPUs, enable quantization, and run MoE models.","href":"/archive/container/guides/configuration"},{"title":"CUDA Compatibility","sidebarTitle":"CUDA Compatibility","description":"The Friendli Engine supports CUDA-enabled NVIDIA GPUs, which means it relies on a specific version of CUDA and necessitates proper CUDA compute compatibilities.","href":"/archive/container/guides/cuda-compatibility"},{"title":"Serving Multi-LoRA Models","sidebarTitle":"Multi-LoRA Serving","description":"Serve multiple LoRA-adapted LLMs simultaneously with Friendli Container without additional GPU resources. No retraining needed for task-specific models.","href":"/archive/container/guides/serving-multi-lora-models"},{"title":"Serving MoE Models","sidebarTitle":"MoE Models Serving","description":"Serve Mixture of Experts (MoE) models like Mixtral 8x7B with Friendli Container. Covers policy search setup and multi-GPU Docker configuration.","href":"/archive/container/guides/serving-moe-models"},{"title":"Quantization","sidebarTitle":"Quantization","description":"Learn how to serve pre-quantized models or perform online quantization with Friendli Container to reduce memory and speed up inference.","href":"/archive/container/guides/quantization"},{"title":"Optimize with Policy Search","sidebarTitle":"Optimize with Policy Search","description":"Boost inference throughput by up to 2x for MoE and quantized models by running execution policy search in Friendli Container for production.","href":"/archive/container/guides/optimizing-inference-with-policy-search"},{"title":"Running Friendli Container on SageMaker","sidebarTitle":"SageMaker Integration","description":"Create a real-time inference endpoint in Amazon SageMaker with Friendli Container. Use Friendli Engine for faster, cost-efficient serving.","href":"/archive/container/guides/sagemaker-integration"},{"title":"Deploy Friendli Container as Amazon EKS Add-On","sidebarTitle":"AWS EKS Add-On","description":"Deploy Friendli Container on Amazon EKS using the official AWS EKS Add-On. Set up GPU nodes, install the add-on, and run model inference.","href":"/archive/container/guides/eks-quickstart"},{"title":"Inference with gRPC","sidebarTitle":"Inference with gRPC","description":"Run a gRPC inference server with Friendli Container and send requests using the Friendli Python SDK. Includes setup, configuration, and code examples.","href":"/archive/container/guides/inference-with-grpc"},{"title":"Observability for Friendli Container","sidebarTitle":"Monitoring","description":"Observability is an integral part of DevOps. To support this, Friendli Container exports internal metrics in a Prometheus text format.","href":"/archive/container/guides/monitoring"}]},{"group":"API Reference","icon":"code","expanded":true,"pages":[{"title":"Container Overview","sidebarTitle":"Overview","description":"API reference for Friendli Container. Browse self-hosted inference endpoints for chat, responses, completions, messages, tokenization, images, and audio transcription.","href":"/openapi/container/overview"},{"group":"Inference","pages":[{"title":"Container Chat Completions","description":"Generate a model response from a list of messages comprising a conversation. Compatible with the OpenAI Chat Completions API, with support for streaming, tool calls, and structured outputs.","deprecated":null,"version":null,"sidebarTitle":"Chat Completions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/chat/completions","href":"/openapi/container/chat-completions"},{"title":"Container Responses","description":"Generate a model response from text or image inputs. Follows the OpenAI Responses API format, with support for streaming, function and custom tool calls, structured outputs, and reasoning controls.","deprecated":null,"version":null,"sidebarTitle":"Responses","tag":"Beta","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/responses","href":"/openapi/container/responses"},{"title":"Container Messages","description":"Generate a model response from a conversation using the Anthropic Messages API format. Supports streaming, function tool calls, and extended thinking.","deprecated":null,"version":null,"sidebarTitle":"Messages","tag":"Beta","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/messages","href":"/openapi/container/messages"},{"title":"Container Completions","description":"Generate a text completion from a prompt or token sequence. Supports streaming and configurable generation parameters.","deprecated":null,"version":null,"sidebarTitle":"Completions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/completions","href":"/openapi/container/completions"},{"title":"Container Text Classification","description":"Classify text input into categories with per-class probabilities.","deprecated":null,"version":null,"sidebarTitle":"Text Classification","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /classify","href":"/openapi/container/text-classification"},{"title":"Container Tokenization","description":"Convert text input into token IDs.","deprecated":null,"version":null,"sidebarTitle":"Tokenization","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/tokenize","href":"/openapi/container/tokenization"},{"title":"Container Detokenization","description":"Convert a list of token IDs back into text.","deprecated":null,"version":null,"sidebarTitle":"Detokenization","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/detokenize","href":"/openapi/container/detokenization"},{"title":"Container Image Generations","deprecated":null,"version":null,"sidebarTitle":"Image Generations","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/images/generations","href":"/openapi/container/image-generations"},{"title":"Container Image Edits","description":"Edit an image based on a text prompt.","deprecated":null,"version":null,"sidebarTitle":"Image Edits","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/images/edits","href":"/openapi/container/image-edits"},{"title":"Container Audio Transcriptions","description":"Transcribe an audio file into text.","deprecated":null,"version":null,"sidebarTitle":"Audio Transcriptions","openapi":"https://github.com/friendliai/friendli-openapi/raw/refs/heads/main/openapi.yaml post /v1/audio/transcriptions","href":"/openapi/container/audio-transcriptions"}]}]}]},{"group":"Friendli Python SDK","pages":[{"title":"Friendli Python SDK","sidebarTitle":"How-To","icon":"file-lines","description":"Install and use the Friendli Python SDK to access Model APIs, Dedicated Endpoints, and Container. Covers chat, completions, streaming, and async usage.","href":"/archive/python-sdk/how-to"}]}]}]},"basePath":"","title":"Container Image Generations","deploymentId":"dpl_2MqcLy8smQrrovUehgcZEsoo1tJX","buildId":"dpl_2MqcLy8smQrrovUehgcZEsoo1tJX","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-c3oKHz6v.js","dist-CLdzWocy.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-DyP0AOE1.js","snippetPresets-CuYPAUIG.js","utils-ez5j6NBT.js","style-to-object-BY3JEAdk.js","utils-DG4aeUOF.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DFhcMUrP.js","conditional-requirements-CFM0id0Q.js","cloneDeep-ByDTqllG.js","_Uint8Array-CJ2WjX_H.js","isObject-FP1Yky1u.js","ApiExamples-fyn9sMD9.js","usePlaygroundInputsStore-Bf0N_Y6L.js","shallow-CnU26VTn.js","isEqual-OWIKZzop.js","CodeSnippets-CZ9-M31v.js","CodeSnippet-CCk6UVRR.js","getApiPlaygroundDisplay-BUw5JwZB.js","Page-CInwEL5w.js","DynamicMarkdown-CU5QIokU.js","SectionHeading-BoT1NwPU.js","icon-MsvNhD56.js","MethodPill-CC7p0-fp.js","getPastedJson-BOWYR2ND.js","DuplicateIcon-DOWJyC1b.js","createIcon-BsNyCaLY.js","axios-CsQoIw0U.js","Markdown-L0uigQE0.js","AssistantPageLink-Cur5OU4v.js"]}