Browse ModelsWavespeed AIAI Fortune Teller

Ai Fortune Teller

Ai Fortune Teller

Playground

Try it on WavespeedAI!

AI Fortune Teller provides personalized fortune reading based on your birth info, with optional palm/face photo analysis. Ready-to-use REST inference API, no coldstarts, affordable pricing.

Features

AI Fortune Teller

AI Fortune Teller is your digital gateway to cosmic insights. Combining ancient fortune-telling traditions — astrology, numerology, palmistry, and face reading — with cutting-edge AI, it delivers personalized destiny readings in seconds. Curious about your love life? Career path? What the stars have in store? Just ask.


Why Choose This?

  • Ancient wisdom meets AI Blends time-honored fortune-telling arts with modern artificial intelligence for surprisingly insightful readings.

  • Your cosmic profile Analyzes your name, birthday, birthplace, and current life circumstances to build a complete picture of your destiny.

  • Palm & face reading Upload a photo of your palm or face to unlock deeper, vision-based insights into your life path.

  • Ask anything Love? Money? Career? Health? Family? That big decision you’ve been putting off? Go ahead, ask.

  • Instant delivery No waiting for the stars to align — get your personalized reading in seconds.


Parameters

ParameterRequiredDescription
nameYesYour name (the universe needs to know who’s asking)
birthdayYesYour birthday — include birth time for extra accuracy
genderYesYour gender: male or female
birthplaceNoWhere your journey began
current_locationNoWhere you are now
is_marriedNoYour relationship status
questionNoWhat’s on your mind? (career, love, health, wealth…)
imageNoPalm or face photo for vision-based reading

How to Use

  1. Introduce yourself — name, birthday, and gender are required.
  2. Add context — birthplace, location, and marital status help refine your reading.
  3. Ask your question — be specific for better insights.
  4. Upload a photo (optional) — palm or face for deeper analysis.
  5. Discover your fortune — click Run and see what destiny has to say.

Pricing

ModeCost
Text only$0.035
With image$0.085

Best Use Cases

  • Life crossroads — Big decision? Let the cosmos weigh in.
  • Love & relationships — Will you find love? Is this the one? What’s next?
  • Career guidance — Should you take that job? Start that business? Ask for that raise?
  • Self-discovery — Learn about your personality, strengths, and hidden potential.
  • Party fun — Fortune readings make great icebreakers and entertainment.
  • Daily curiosity — What does today have in store for you?

Pro Tips

  • Birth time matters — include it for significantly more accurate readings.
  • Specific questions get specific answers — “Will I get promoted this year?” beats “Tell me about my career.”
  • For palm readings: clear lighting, flat hand, fingers spread.
  • For face readings: front-facing, well-lit, neutral expression.
  • Try multiple questions to explore different aspects of your fortune.

Notes

  • Name, birthday, and gender are required fields.
  • Image analysis adds $0.05 for enhanced vision-based insights.
  • For entertainment purposes — the future is still yours to write.

Authentication

For authentication details, please refer to the Authentication Guide.

API Endpoints

Submit Task & Query Result


# Submit the task
curl --location --request POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/ai-fortune-teller" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}" \
--data-raw '{
    "is_married": false
}'

# Get the result
curl --location --request GET "https://api.wavespeed.ai/api/v3/predictions/${requestId}/result" \
--header "Authorization: Bearer ${WAVESPEED_API_KEY}"

Parameters

Task Submission Parameters

Request Parameters

ParameterTypeRequiredDefaultRangeDescription
namestringYes--Your name.
birthdaystringYes--Your birthday with time for more accuracy (e.g. 1990-01-15 08:30).
genderstringYes-male, femaleYour gender.
birthplacestringNo--Your birthplace (optional).
current_locationstringNo--Your current location (optional).
is_marriedbooleanNofalse-Whether you are married.
questionstringNo--Specific question about career, love, health, etc. (optional).
imagestringNo-Palm or face photo for vision-based reading (optional).

Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
data.idstringUnique identifier for the prediction, Task Id
data.modelstringModel ID used for the prediction
data.outputsarrayArray of URLs to the generated content (empty when status is not completed)
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.has_nsfw_contentsarrayArray of boolean values indicating NSFW detection for each output
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds

Result Request Parameters

ParameterTypeRequiredDefaultDescription
idstringYes-Task ID

Result Response Parameters

ParameterTypeDescription
codeintegerHTTP status code (e.g., 200 for success)
messagestringStatus message (e.g., “success”)
dataobjectThe prediction data object containing all details
data.idstringUnique identifier for the prediction, the ID of the prediction to get
data.modelstringModel ID used for the prediction
data.outputsstringArray of URLs to the generated content (empty when status is not completed).
data.urlsobjectObject containing related API endpoints
data.urls.getstringURL to retrieve the prediction result
data.statusstringStatus of the task: created, processing, completed, or failed
data.created_atstringISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.errorstringError message (empty if no error occurred)
data.timingsobjectObject containing timing details
data.timings.inferenceintegerInference time in milliseconds
© 2025 WaveSpeedAI. All rights reserved.