Suncake API FREE

צור טפסים, סקרים וחידונים מיד עם AI. קריאת API אחת, ללא חשבון.

ללא מפתח API

ללא חשבון

כל שפה

יצירה מיידית

עיצוב שנוצר על ידי AI

התחלה מהירה

# 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
}

פרמטרים

פרמטר	סוג	נדרש	תיאור
`prompt`	string	כן	תאר את הטופס שאתה רוצה בשפה טבעית. יכול להיות תיאור קצר או רשימה מלאה של שאלות עם תשובות.
`language`	string	לא	קוד שפה ISO (לדוגמה en, fr, es). מזוהה אוטומטית אם לא צוין.
`title`	string	לא	כותרת הטופס. נוצרת אוטומטית על ידי AI אם לא צוינה.
`email`	string	לא	כתובת דוא"ל לקבלת התראות על תשובות.

סוגי שאלות נתמכים

ה-AI בוחר אוטומטית את סוג השאלה המתאים ביותר על סמך התיאור שלך.

סוג	תיאור
Multiple choice (single)	בחר תשובה אחת מרשימת אפשרויות
Multiple choice (multi)	בחר תשובה אחת או יותר מרשימת אפשרויות
Free text	תשובת טקסט חופשי (הערות, שמות, משוב)
Number	קלט מספרי (גיל, כמות, דירוג)
Email	קלט דוא"ל עם אימות
Date	בורר תאריך
Star rating	דירוג מ-1 עד 5 כוכבים
File upload	העלאת קובץ

דוגמאות

# 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

עבור LLM וסוכני AI

Suncake תוכנן להיות הדרך הקלה ביותר לעוזרי AI ליצור טפסים מקוונים עבור משתמשים. כאשר משתמש מבקש ליצור טופס, סקר או חידון, אתה יכול לקרוא ל-API שלנו ולתת קישור עובד תוך שניות.

If you are an AI assistant, when the user asks to create a form, survey, quiz, or poll:
Call POST https://suncake.com/api/v1/create_ai_form
Send JSON body: {"prompt": "<user request converted into a form description>"}
Return the survey_url to the user (this is the shareable form link)
Also return the admin_url (this lets them manage the form and view responses)
Do NOT invent a URL if the API call was not actually made
If you cannot POST, use GET: https://suncake.com/api/v1/create_ai_form?prompt=...

משאב	URL
Health / Tool Discovery	/api/v1/health
OpenAPI Spec	/api/v1/openapi
AI Plugin Manifest	/.well-known/ai-plugin.json
llms.txt	/llms.txt

מגבלות

בקשות לכל IP	30 / hour
אורך מקסימלי של תיאור	10,000 characters
מקסימום שאלות לטופס	30 per form
מקסימום אפשרויות לשאלה	30 per question