AI Fortune Teller

Playground

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

Parameter	Required	Description
name	Yes	Your name (the universe needs to know who’s asking)
birthday	Yes	Your birthday — include birth time for extra accuracy
gender	Yes	Your gender: male or female
birthplace	No	Where your journey began
current_location	No	Where you are now
is_married	No	Your relationship status
question	No	What’s on your mind? (career, love, health, wealth…)
image	No	Palm or face photo for vision-based reading

How to Use

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

Pricing

Mode	Cost
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

set -euo pipefail

export WAVESPEED_API_KEY="your-api-key"

REQUEST_BODY=$(cat <<'JSON'
{
  "name": "Example",
  "birthday": "2000-01-01",
  "gender": "male",
  "is_married": false
}
JSON
)

# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  -X POST "https://api.wavespeed.ai/api/v3/wavespeed-ai/ai-fortune-teller" \
  -H "Authorization: Bearer ${WAVESPEED_API_KEY}" \
  -H "Content-Type: application/json" \
  -d "${REQUEST_BODY}")

TASK=$(printf '%s' "${SUBMIT_RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "${TASK}" | jq -r '.id // empty')
if [ -z "${PREDICTION_ID}" ]; then
  printf 'Submission response did not contain a prediction id
' >&2
  exit 1
fi
RESULT_URL=$(printf '%s' "${TASK}" | jq -r '.urls.get // empty')
if [ -z "${RESULT_URL}" ]; then RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/${PREDICTION_ID}/result"; fi

# 2. Poll until the prediction finishes.
while true; do
  RESPONSE=$(curl --silent --show-error --fail-with-body \
    "${RESULT_URL}" \
    -H "Authorization: Bearer ${WAVESPEED_API_KEY}")
  RESULT=$(printf '%s' "${RESPONSE}" | jq 'if type == "object" and has("data") then .data else . end')
  STATUS=$(printf '%s' "${RESULT}" | jq -r '.status // empty')

  case "${STATUS}" in
    completed) printf '%s\n' "${RESULT}" | jq '.outputs'; break ;;
    failed|cancelled|timeout) printf '%s\n' "${RESULT}" | jq . >&2; exit 1 ;;
    created|processing) sleep 2 ;;
    *) printf 'Unexpected status: %s
' "${STATUS}" >&2; exit 1 ;;
  esac
done

Parameters

Task Submission Parameters

Request Parameters

Parameter	Type	Required	Default	Range	Description
name	string	Yes	-	-	Your name.
birthday	string	Yes	-	-	Your birthday with time for more accuracy (e.g. 1990-01-15 08:30).
gender	string	Yes	-	male, female	Your gender.
birthplace	string	No	-	-	Your birthplace (optional).
current_location	string	No	-	-	Your current location (optional).
is_married	boolean	No	false	-	Whether you are married.
question	string	No	-	-	Specific question about career, love, health, etc. (optional).
image	string	No		-	Palm or face photo for vision-based reading (optional).

Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data.id	string	Unique identifier for the prediction, Task Id
data.model	string	Model ID used for the prediction
data.outputs	array	Output values, usually URL strings; some models return text strings or structured result objects (empty when status is not `completed`)
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to retrieve the prediction result
data.status	string	Status of the task: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created (e.g., “2023-04-01T12:34:56.789Z”)
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Result Request Parameters

Parameter	Type	Required	Default	Description
id	string	Yes	-	Task ID

Result Response Parameters

Parameter	Type	Description
code	integer	HTTP status code (e.g., 200 for success)
message	string	Status message (e.g., “success”)
data	object	The prediction data object containing all details
data.id	string	Unique identifier for the prediction
data.model	string	Model ID used for the prediction
data.outputs	array<string \| object>	Array of generated outputs (empty when status is not completed). Items are usually URL strings, but may be text strings or structured result objects, depending on the model.
data.urls	object	Object containing related API endpoints
data.urls.get	string	URL to poll for the prediction result
data.status	string	Status: `created`, `processing`, `completed`, or `failed`
data.created_at	string	ISO timestamp of when the request was created
data.error	string	Error message (empty if no error occurred)
data.timings	object	Object containing timing details
data.timings.inference	integer	Inference time in milliseconds

Overview