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.

POST /v1/experiences/love-revealQuickstartOpenAPI JSON
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

4 functions
love.reveal.generate

Creates the final structured love reveal experience.

question.intent.classify

Classifies breakup, crush, commitment, return, or future-love intent.

tarot.symbols.attach

Adds tarot structure only when it sharpens the answer.

relationship.context.ground

Prevents 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
HTTPCodePartner Action
400INVALID_REQUESTFix the payload shape, enum value, required field, or request body before retrying.
401AUTH_REQUIREDSend x-api-key from a trusted server environment. Do not expose keys in browser code.
401AUTH_INVALIDCheck the key prefix, rotate compromised keys, and verify the target environment.
402CREDITS_EXHAUSTEDUpgrade the plan, add credits, or switch to a lower-cost Core Compute route.
403AUTH_FORBIDDENUse a key scoped for this endpoint or upgrade to the required plan.
404NOT_FOUNDVerify the job id, environment, API key, and whether the job belongs to the same workspace.
409IDEMPOTENCY_CONFLICTReuse idempotency keys only for the same logical operation and identical request payload.
429RATE_LIMITEDBack off, retry later, reduce concurrency, or request enterprise limits.
Related Endpoints