curl --request POST \
--url https://www.gostudio.ai/api/v2/image-to-prompt \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"image_url": "https://example.com/landscape.jpg",
"prompt_mode": "standalone"
}
'{
"status": 200,
"prompt": "Two professionals, <image1> male and <image2> female, standing in a modern glass office lobby with city views"
}{
"status": 400,
"error": {
"type": "validation_error",
"code": "invalid_input",
"dev": 40001,
"message": "Some information is invalid."
}
}{
"status": 401,
"error": {
"type": "authentication_error",
"code": "unauthorized",
"dev": 40100,
"message": "Missing or invalid Authorization Bearer token."
}
}{
"status": 429,
"error": {
"type": "rate_limit_error",
"code": "rate_limited",
"dev": 42900,
"message": "You're doing that too often. Please wait a moment."
}
}{
"status": 500,
"error": {
"type": "system_error",
"code": "internal_error",
"dev": 50000,
"message": "Something went wrong on our end."
}
}{
"status": 502,
"error": {
"type": "provider_error",
"code": "provider_bad_gateway",
"dev": 50200,
"message": "Generation is having trouble right now. Please try again."
}
}Image
Analyze an image and generate a text prompt
Analyzes an image and returns a descriptive text prompt suitable for use in generation endpoints.
Two modes are supported:
standalone: produces a single<image1>reference tag prompt.reference: produces per-person<imageN>tags using gender and count hints, suitable for multi-person scene prompts.
No credits are deducted; this is a utility endpoint.
POST
/
api
/
v2
/
image-to-prompt
curl --request POST \
--url https://www.gostudio.ai/api/v2/image-to-prompt \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"image_url": "https://example.com/landscape.jpg",
"prompt_mode": "standalone"
}
'{
"status": 200,
"prompt": "Two professionals, <image1> male and <image2> female, standing in a modern glass office lobby with city views"
}{
"status": 400,
"error": {
"type": "validation_error",
"code": "invalid_input",
"dev": 40001,
"message": "Some information is invalid."
}
}{
"status": 401,
"error": {
"type": "authentication_error",
"code": "unauthorized",
"dev": 40100,
"message": "Missing or invalid Authorization Bearer token."
}
}{
"status": 429,
"error": {
"type": "rate_limit_error",
"code": "rate_limited",
"dev": 42900,
"message": "You're doing that too often. Please wait a moment."
}
}{
"status": 500,
"error": {
"type": "system_error",
"code": "internal_error",
"dev": 50000,
"message": "Something went wrong on our end."
}
}{
"status": 502,
"error": {
"type": "provider_error",
"code": "provider_bad_gateway",
"dev": 50200,
"message": "Generation is having trouble right now. Please try again."
}
}Authorizations
Supabase user JWT (or an internal service token). Send as Authorization: Bearer <token>.
Body
application/json
HTTPS URL of the image to analyze.
Example:
"https://example.com/photo.jpg"
Analysis mode. standalone produces a single <image1> reference tag. reference produces per-person <imageN> tags using gender and count hints.
Available options:
standalone, reference Required when prompt_mode is reference.
Show child attributes
Show child attributes