Skip to main content
POST
/
api
/
v1
/
generate
/
text
Generate text
curl --request POST \
  --url https://itz.am/api/v1/generate/text \
  --header 'Api-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "input": "Tell me about renewable energy",
  "type": "<string>",
  "callback": {
    "url": "https://example.com/callback",
    "customProperties": {},
    "headers": {}
  },
  "workflowSlug": "my_great_workflow",
  "attachments": [
    {
      "file": "file_data",
      "mimeType": "application/pdf"
    },
    {
      "file": "image_data",
      "mimeType": "image/png"
    },
    {
      "file": "https://example.com/image.jpg"
    }
  ],
  "contextSlugs": [
    "special-docs",
    "admin-files"
  ]
}
'
{
  "text": "Renewable energy is...",
  "metadata": {
    "runId": "run_1234567890",
    "cost": "0.001",
    "model": {
      "name": "gpt-4o",
      "tag": "openai:gpt-4o"
    },
    "durationInMs": 1000,
    "inputTokens": 1000,
    "outputTokens": 1000
  }
}

Authorizations

​
Api-Key
string
header
required

The API key to use for authentication

Body

application/json
​
input
string
required

The input text to generate a response for

Minimum string length: 1
Example:

"Tell me about renewable energy"

​
type
string
required
Allowed value: "event"
​
callback
object
required
​
workflowSlug
string
required

The slug of the Workflow to use for generation

Example:

"my_great_workflow"

​
attachments
object[]

Optional attachments to include in the generation

Example:
[
  {
    "file": "file_data",
    "mimeType": "application/pdf"
  },
  {
    "file": "image_data",
    "mimeType": "image/png"
  },
  { "file": "https://example.com/image.jpg" }
]
​
contextSlugs
string[]

Optional context slugs to add contexts to the run

Example:
["special-docs", "admin-files"]

Response

Successfully generated content (we also return the run ID in the header X-Run-ID)

​
text
string
required

The generated output text

Example:

"Renewable energy is..."

​
metadata
object
required