Skip to content
96Astro API
Get API Key

Face reading

Available

Face: Eyes API

Eye shape, spacing and brows. Read from one photo of the face by a vision model; the photo is not stored.

  • POST /v1/face-reading/face-eyes
  • Metered, from 15 credits
Get a free key API reference
Request
curl https://api.96astroapi.com/v1/face-reading/face-eyes \  -H "Authorization: Bearer $ASTRO_API_KEY" \  -H "Content-Type: application/json" \  -d '{
      "image_base64": "iVBORw0KGgoAAAANSUhEUgAAAKAAAAB4CAAAAABQyaazAAAAgklEQVR42u3bQQoAIAgEQP//6fpCBsFWs2fBEbyJNcJTgICAgIDXACspgIeAp/aouvWAgICAgICAgICAgICAgICAgICAgICAgICAgICAgGsN0+/F4cCNgQABAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQE7QA/QbwMzAwgICPg7cAJxuHlDZty0owAAAABJRU5ErkJggg==",
      "mime_type": "image/png",
      "consent": true,
      "tier": "fast"
    }'

Overview

Eye shape, spacing and brows. Read from one photo of the face by a vision model; the photo is not stored.

Call it with POST /v1/face-reading/face-eyes. Input: a photo. Output: JSON, as a direct response. Each successful call costs metered, from 15 credits.

  • POST /v1/face-reading/face-eyes
  • Metered, from 15 credits
  • A photo

Example response

Fields in dataThe response contract: required fields are always present.

  • sectionsobject
  • noticestring
  • tierstring
  • languagestring
200Example response (illustrative)

Written by hand from the documented shape: AI readings are not captured automatically. Real text, token counts and credits differ.

Loading the example…

Request schema and every field: the Face reading reference.

Related endpoints

FAQ

Face: Eyes API: common questions

4answers

Ask the team
01What does the Face: Eyes API return?

Eye shape, spacing and brows. Read from one photo of the face by a vision model; the photo is not stored. The response's data object includes sections, notice, tier and language. See the reference for an example response.

02What input does Face: Eyes need?

A photo.

03How much does a Face: Eyes call cost?

Metered, from 15 credits per successful call; a failed call is not charged. Plans and top-ups are on the pricing page.

04Can I try it before paying?

Yes. Every account gets sandbox keys and trial credits, so you can call it from your own code before choosing a plan.