yaddayadda.io

Batch Endpoint (Coming Soon)

Generate multiple templates in a single request with shared topic and tone.

Coming soon — This endpoint is planned but not yet available. The documentation below is a preview of the intended API. For now, make separate requests to /v1/generate for each template.

Endpoint

POST /v1/generate/batch

Generate multiple templates in a single request. All templates share the same topic and tone, ensuring consistent content across sections.

Request Body

{
  "topic": "fintech startup for millennials",
  "tone": "corporate_buzzword",
  "requests": [
    { "template": "navbar" },
    { "template": "hero_section" },
    { "template": "features_grid", "count": 4 },
    { "template": "testimonials", "count": 3 },
    { "template": "pricing_table", "tiers": 3 },
    { "template": "footer" }
  ]
}
FieldTypeRequiredDescription
topicstringNoShared topic for all templates
tonestringNoShared tone preset for all templates
requestsarrayYesArray of template requests
requests[].templatestringYesTemplate ID
requests[].countintegerNoItem count (for templates that support it)
requests[].tiersintegerNoTier count (for pricing_table)

Billing

Each item in the requests array counts as one generation against your quota. A batch of 6 templates uses 6 generations.

Internally, batch requests are combined into fewer AI calls for cost efficiency — but billing is per template.

Authentication

  • Without API key: All templates return Yadda Ipsum (static content)
  • With API key + topic/tone: All templates return AI-generated content

Example

curl -X POST "https://api.yaddayadda.io/v1/generate/batch" \
  -H "Authorization: Bearer yda_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "pet adoption platform",
    "tone": "enthusiastic_intern",
    "requests": [
      { "template": "hero_section" },
      { "template": "features_grid", "count": 3 },
      { "template": "testimonials", "count": 3 }
    ]
  }'

On this page