Image Generation (OpenAI)

Parameters

Header parameters

Name	Type	Required	Description
Content-Type	string	Yes	—
Authorization	string	Yes	—

Request body

Content-Type: application/json

bodyobjectrequired

modelstringrequiredModel name

promptstringrequiredPrompt text

nnumberrequiredNumber of images to generate. Must be between 1 and 10. Default 1.

qualitystringoptionalImage quality. One of `standard` or `hd`.

sizestringrequiredImage dimensions. Default `1024x1024`.

response_formatstringrequiredResponse format. `url` or `b64_json`.

Responses

200

responseobjectoptional

creatednumberrequiredUnix timestamp (in seconds) of when the response was created.

backgroundstringrequired

dataarrayrequiredList of generated image objects.

urlstringoptionalWhen `response_format` is `url` (default), the URL of the generated image.

b64_jsonstringoptionalWhen `response_format` is `b64_json`, the base64-encoded image bytes.

revised_promptstringoptionalIf the prompt was revised, the revised prompt that was used to generate the image.

output_formatstringrequired

qualitystringrequired

sizestringrequired

usageobjectrequiredUsage statistics for this request.

input_tokensnumberrequiredNumber of tokens consumed by the input.

input_tokens_detailsobjectrequiredBreakdown of input tokens into text and image tokens.

image_tokensnumberrequired

text_tokensnumberrequired

output_tokensnumberrequiredNumber of tokens consumed by the output.

total_tokensnumberrequiredTotal tokens consumed.

Request example

curl -X POST "https://api.tokengo.com/v1/images/generations" \
  -H "Content-Type: <Content-Type>" \
  -H "Authorization: <Authorization>" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "string",
  "prompt": "string",
  "n": 0,
  "quality": "string",
  "size": "string",
  "response_format": "string"
}'

Response200

{
  "created": 0,
  "background": "string",
  "data": [
    {
      "url": "string",
      "b64_json": "string",
      "revised_prompt": "string"
    }
  ],
  "output_format": "string",
  "quality": "string",
  "size": "string",
  "usage": {
    "input_tokens": 0,
    "input_tokens_details": {
      "image_tokens": 0,
      "text_tokens": 0
    },
    "output_tokens": 0,
    "total_tokens": 0
  }
}