POSTalphaExperience APIs
Love Reveal
Generate a high-specificity love reading that can blend psychic interpretation, tarot symbolism, owned astrology context, and 5-7-8 relationship logic.
Credits
5 credits per reveal
Minimum Plan
Pro+
Billing Lane
Premium AI
SDK Helper
loveReveal / love_reveal
Inputs
- +question
- +relationship context
- +optional birth data
- +optional partner birth data
- +tone
Outputs
- +direct answer
- +emotional dynamic
- +tarot/love archetypes
- +astrology support
- +next action
Tool Functions
Capabilities behind this endpoint
love.reveal.generateCreates the final structured love reveal experience.
question.intent.classifyClassifies breakup, crush, commitment, return, or future-love intent.
tarot.symbols.attachAdds tarot structure only when it sharpens the answer.
relationship.context.groundPrevents generic love output by anchoring to the provided situation.
Love Reveal request
{
"question": "Is this connection coming back or should I move on?",
"subject": { "id": "user_123", "dob": "1990-07-23" },
"context": {
"relationship_status": "separated",
"desired_tone": "clear and compassionate"
}
}Love Reveal response
{
"request_id": "req_...",
"data": {
"answer": "This connection is not fully closed, but the return depends on whether accountability replaces silence.",
"dynamic": "strong chemistry with weak consistency",
"next_action": "Do not chase. Ask one direct question and watch behavior, not emotion."
},
"usage": { "lane": "ai", "credits": 5, "billableUnits": 1 },
"meta": { "status": "alpha", "persona": "lady-avalon" }
}curl
curl https://theleokingai.com/api/v1/experiences/love-reveal \
-X POST \
-H "Accept: application/json" \
-H "x-api-key: $LEOKING_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: love-reveal-subject-123-v1" \
-d '{
"question": "Is this connection coming back or should I move on?",
"subject": { "id": "user_123", "dob": "1990-07-23" },
"context": {
"relationship_status": "separated",
"desired_tone": "clear and compassionate"
}
}'Node SDK
import { TheLeoKingApi } from "@theleoking/ai-api";
const api = new TheLeoKingApi({
apiKey: process.env.LEOKING_API_KEY,
baseUrl: "https://theleokingai.com/api"
});
const result = await api.loveReveal(
{
"question": "Is this connection coming back or should I move on?",
"subject": { "id": "user_123", "dob": "1990-07-23" },
"context": {
"relationship_status": "separated",
"desired_tone": "clear and compassionate"
}
},
"love-reveal-subject-123-v1"
);
console.log(result.request_id);
console.log(result.usage.credits);Python SDK
import os
from theleoking_ai_api import TheLeoKingApi
api = TheLeoKingApi(
api_key=os.environ["LEOKING_API_KEY"],
base_url="https://theleokingai.com/api",
)
result = api.love_reveal(
{
"question": "Is this connection coming back or should I move on?",
"subject": {
"id": "user_123",
"dob": "1990-07-23",
},
"context": {
"relationship_status": "separated",
"desired_tone": "clear and compassionate",
},
},
idempotency_key="love-reveal-subject-123-v1",
)
print(result["request_id"])
print(result["usage"]["credits"])Error Behavior
| HTTP | Code | Partner Action |
|---|---|---|
| 400 | INVALID_REQUEST | Fix the payload shape, enum value, required field, or request body before retrying. |
| 401 | AUTH_REQUIRED | Send x-api-key from a trusted server environment. Do not expose keys in browser code. |
| 401 | AUTH_INVALID | Check the key prefix, rotate compromised keys, and verify the target environment. |
| 402 | CREDITS_EXHAUSTED | Upgrade the plan, add credits, or switch to a lower-cost Core Compute route. |
| 403 | AUTH_FORBIDDEN | Use a key scoped for this endpoint or upgrade to the required plan. |
| 404 | NOT_FOUND | Verify the job id, environment, API key, and whether the job belongs to the same workspace. |
| 409 | IDEMPOTENCY_CONFLICT | Reuse idempotency keys only for the same logical operation and identical request payload. |
| 429 | RATE_LIMITED | Back off, retry later, reduce concurrency, or request enterprise limits. |
Related Endpoints