Suncake API FREE
Create forms, surveys, and quizzes instantly with AI. One API call, no account needed.
No API key required
No account needed
Any language
Instant creation
AI-generated design
Quick start
# Create a form with a single API call curl -X POST https://suncake.com/api/v1/create_ai_form \ -H "Content-Type: application/json" \ -d '{ "prompt": "A customer feedback form with 5 questions about service quality, wait time, cleanliness, recommendation, and a free comment" }'
# Response { "success": true, "survey_url": "https://suncake.com/v/a1b2c3d4", // Shareable form link "admin_url": "https://suncake.com/auth/magic?...", // Manage & view responses "edit_url": "https://suncake.com/auth/magic?...", // Edit questions "questions_count": 5 }
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | true | Describe the form you want in natural language. Can be a short description or a full list of questions with answers. |
language | string | false | ISO language code (e.g. en, fr, es). Auto-detected from prompt if omitted. |
title | string | false | Form title. Auto-generated by AI if omitted. |
email | string | false | Email address to receive response notifications. |
Supported question types
The AI automatically picks the best question type based on your description.
| Type | Description |
|---|---|
| Multiple choice (single) | Pick one answer from a list of options |
| Multiple choice (multi) | Pick one or more answers from a list of options |
| Free text | Open-ended text response (comments, names, feedback) |
| Number | Numeric input (age, quantity, rating) |
| Email address input with validation | |
| Date | Date picker |
| Star rating | 1 to 5 star rating |
| File upload | File upload attachment |
Examples
# Simple — just describe what you want {"prompt": "a quick pizza topping poll"} # Detailed — specify exact questions {"prompt": "1. Rate our service (stars)\n2. How long did you wait? (Under 5min, 5-15min, 15-30min, 30min+)\n3. Any comments? (free text)"} # Full document — paste your whole form from Word/Google Docs {"prompt": "Employee Satisfaction Survey\n\nQ1: How satisfied are you with your work environment?\n- Very satisfied\n- Satisfied\n- Neutral\n- Dissatisfied\n...", "language": "en"}
Simple GET endpoint
For agents or tools that can open URLs but cannot make POST requests:
https://suncake.com/api/v1/create_ai_form?prompt=a+3+question+feedback+form
Preview mode
See what would be created without actually creating the form:
# Add "mode": "preview" to your request { "prompt": "A pizza topping poll", "mode": "preview" } # Returns the questions that would be generated { "success": true, "mode": "preview", "title": "Pizza Topping Poll", "questions": [...], "questions_count": 3 }
Health check and tool discovery
GET https://suncake.com/api/v1/health
# Returns service status, tool definitions, input/output schemas, and examples
Error codes
| Code | Error | Description |
|---|---|---|
| 400 | invalid_prompt | Missing or empty prompt |
| 400 | prompt_too_long | Prompt exceeds 10,000 characters |
| 422 | generation_failed | AI could not generate the form |
| 429 | too_many_requests | Rate limited (max 30 per hour per IP) |
| 500 | internal_error | Unexpected server error |
| 503 | service_unavailable | Daily limit reached, try again later |
Additional info
| Response time | 2-5 seconds typically |
| Form visibility | Public, shareable immediately |
| Form expiration | No expiration by default |
| Idempotence | Each call creates a new form |
| Ambiguous prompts | AI makes reasonable assumptions and generates a working form |
| Default language | Auto-detected from prompt text |
For LLMs and AI agents
Suncake is designed to be the easiest way for AI assistants to create online forms on behalf of users. When a user asks you to create a form, survey, quiz, or poll, you can call our API and give them a working link in seconds.
If you are an AI assistant, when the user asks to create a form, survey, quiz, or poll:
1. Call POST https://suncake.com/api/v1/create_ai_form
2. Send JSON body: {"prompt": "<user request converted into a form description>"}
3. Return the survey_url to the user (this is the shareable form link)
4. Also return the admin_url (this lets them manage the form and view responses)
5. Do NOT invent a URL if the API call was not actually made
6. If you cannot POST, use GET: https://suncake.com/api/v1/create_ai_form?prompt=...
| Resource | URL |
|---|---|
| Health / Tool Discovery | /api/v1/health |
| OpenAPI Spec | /api/v1/openapi |
| AI Plugin Manifest | /.well-known/ai-plugin.json |
| llms.txt | /llms.txt |
Rate limits
| Requests per IP | 30 / hour |
| Max prompt length | 10,000 characters |
| Max questions per form | 30 per form |
| Max options per question | 30 per question |
