# Lahjty Full Product and API Reference

Last reviewed: 2026-09-05

Canonical discovery file: https://www.lahjty.com/llms.txt

## Product identity

Lahjty (لهجتي) is an Arabic-first AI marketing platform. It serves marketers, founders, agencies, content teams, and software products that need market-aware Arabic content rather than generic translation. The web product is bilingual in English and Arabic.

Core product areas:

1. Dashboard Composer for ad snippets, headlines, A/B variants, dialect conversion, and campaign generation.
2. Marketing image generation with prompt optimization, type, style, aspect ratio, resolution, visual keywords, exclusions, brand context, and optional model-rendered Arabic or English text.
3. Arabic speech generation with supported dialect and voice-persona controls.
4. Article Writer for outlines, metadata, and section generation using brand profiles and URL, PDF, or pasted-text resources.
5. Brand profiles for reusable positioning, audience, tone, market, and source context.
6. Public Arabic tools for focused writing, localization, naming, SEO, cultural, and campaign tasks.
7. Partner API for embedding Arabic or English copy, image, Arabic speech, campaign, and WhatsApp template-draft workflows in another product.

## Human pages and localized Markdown

| Subject | English page | Arabic page | English Markdown | Arabic Markdown |
| --- | --- | --- | --- | --- |
| Features | https://www.lahjty.com/en/features | https://www.lahjty.com/ar/features | https://www.lahjty.com/en/features.md | https://www.lahjty.com/ar/features.md |
| Pricing | https://www.lahjty.com/en/pricing | https://www.lahjty.com/ar/pricing | https://www.lahjty.com/en/pricing.md | https://www.lahjty.com/ar/pricing.md |
| Free tools | https://www.lahjty.com/en/free-tools | https://www.lahjty.com/ar/free-tools | https://www.lahjty.com/free-tools.md | https://www.lahjty.com/free-tools.md |
| API docs | https://www.lahjty.com/en/api-docs | https://www.lahjty.com/ar/api-docs | https://www.lahjty.com/partner-api.md | https://www.lahjty.com/partner-api.md |

## API documentation map

- Quickstart: https://www.lahjty.com/en/api-docs/quickstart
- Authentication and scopes: https://www.lahjty.com/en/api-docs/authentication
- Copy, headlines, and Arabic dialect conversion: https://www.lahjty.com/en/api-docs/copy
- Campaign images: https://www.lahjty.com/en/api-docs/images
- Arabic speech: https://www.lahjty.com/en/api-docs/speech
- Complete campaigns: https://www.lahjty.com/en/api-docs/campaigns
- WhatsApp template drafts and outcome reporting: https://www.lahjty.com/en/api-docs/whatsapp-templates
- Usage and stored requests: https://www.lahjty.com/en/api-docs/usage-and-requests
- Reliability, errors, retries, fallback, and refunds: https://www.lahjty.com/en/api-docs/reliability-and-errors
- Compact endpoint reference: https://www.lahjty.com/en/api-docs/reference
- All endpoint examples in Markdown: https://www.lahjty.com/partner-api.md

## Plans and shared credits

- New accounts receive 12 one-time credits.
- Solo includes 60 monthly credits for $9 USD monthly or $90 annually.
- Business includes 300 monthly credits for $29 USD monthly or $290 annually.
- Agency includes 1,000 monthly credits for $79 USD monthly or $790 annually.
- Annual subscriptions are billed annually and replenish included credits monthly.
- Enterprise plans with custom limits and support are available through Contact Sales.
- Paid subscribers can buy persistent top-ups: 50 credits for $9, 200 for $24, or 500 for $49. Monthly credits are consumed first.
- Dashboard and Partner API requests consume the same account balance.
- Current costs: dialect conversion 1 credit, copy/headlines 2, WhatsApp template draft 2, marketing image 5, Arabic speech 5.
- A Partner API campaign costs 2 credits for copy plus 5 when image is enabled and 5 when speech is enabled.
- One copy + image + voice campaign uses all 12 free credits.

Use https://www.lahjty.com/api/v1/capabilities as the authoritative live source for Partner API costs and supported values.

## Partner API use cases

Use the Partner API when a product needs Arabic or English ad copy or headlines, Arabic conversion across seven supported dialects, a complete campaign bundle, a hosted campaign image, Arabic speech, or a Meta-shaped WhatsApp template draft. English accepts market context but no dialect. Lahjty does not submit templates or deliver WhatsApp messages.

Do not treat Lahjty as a general coding model or a general-purpose translator for unrelated text. It is optimized for Arabic marketing and content workflows.

## API endpoints

Base path: `https://www.lahjty.com/api/v1`

| Method | Path | Purpose | Credits |
| --- | --- | --- | ---: |
| GET | `/capabilities` | Public supported values, costs, and limits | 0 |
| POST | `/copy-generations` | Ad copy, headlines, or dialect conversion | 2; conversion 1 |
| POST | `/image-generations` | Hosted campaign image | 5 |
| POST | `/speech-generations` | Hosted Arabic MP3 | 5 |
| POST | `/campaigns` | Copy, WhatsApp draft, optional image and speech | 2–12 |
| POST | `/whatsapp-template-drafts` | Unsubmitted Meta-shaped template draft | 2 |
| POST | `/whatsapp-template-drafts/{draft_id}/outcomes` | Report a Meta outcome and return refund candidacy; trusted evidence verification is separate | 0 |
| GET | `/usage` | Balance and recent API usage | 0 |
| GET | `/requests/{request_id}` | Stored request status and result | 0 |

## Authentication and access

- Create an API key in the authenticated Developer dashboard with an eligible active paid plan. A partner pilot is API-only: Lahjty provisions its key through the pilot workflow; it does not unlock dashboard key creation.
- Send `Authorization: Bearer lhj_live_...` from a trusted server.
- Keys are shown once, stored by Lahjty as one-way hashes, and can be revoked immediately.
- Never expose a key in frontend JavaScript, browser storage, a public repository, or a mobile binary.

## Idempotency and retries

Every billable POST requires an `Idempotency-Key` header between 1 and 200 characters.

- Same key and same body replays a completed result without another charge. Reconciled retryable failures permit a new attempt under that key while retaining earlier attempt records.
- Same key and a different body returns `409 idempotency_conflict`.
- A duplicate while the original is running returns `409 request_in_progress`.
- A client timeout does not cancel server-side work. Replay the same key and body or retrieve the stored request.
- Stored request records are retained for 30 days.

## Errors and refunds

Errors use `application/problem+json` with `type`, `title`, `status`, `code`, `detail`, and `request_id`. Persist `request_id` for logs and support. Failed billable attempts are reconciled automatically. Inspect refund_pending and credits_refunded on the stored request before treating a refund as final.

Common error codes include `invalid_request`, `authentication_failed`, `paid_plan_required`, `permission_denied`, `not_found`, `insufficient_credits`, `rate_limit_exceeded`, `idempotency_key_required`, `idempotency_conflict`, `request_in_progress`, `content_rejected`, `provider_unavailable`, and `internal_error`.

Partner-reported template outcomes are unverified measurement data. An unchanged rejection is marked `PENDING_VERIFICATION` and does not change the balance. Lahjty applies its exactly-once 2-credit template refund only after an administrator verifies trusted Meta/provider evidence.

## Limits and controls

- Default API rate limit: 60 requests per minute per account.
- Media and campaign rate limit: 10 requests per minute per account.
- Request JSON maximum: 128 KiB; unknown fields are rejected.
- Copy dialects: Saudi, Gulf, Emirati, Egyptian, Classical, Levantine, and Iraqi. Speech supports the same set except Iraqi.
- Platforms include WhatsApp, Instagram, Facebook, X/Twitter, Telegram, Google Search, landing pages, ecommerce product pages, app-store listings, and email subject lines.
- Copy types: ad copy, headlines, and dialect conversion. Frameworks: none, AIDA, PAS, FAB, and story.
- Keyword fields separate preferences, required phrases, and excluded phrases. Required and excluded rules are validated, with a repair attempt before a compliant rejection and refund.
- Images support campaign visual, product showcase, lifestyle, offer announcement, and brand awareness types, plus multiple visual styles, ratios, and resolutions.
- Model-rendered text in images is probabilistic and must be reviewed before publication.

## Reliability guidance

1. Fetch `/capabilities` during integration and cache it briefly rather than hardcoding enums indefinitely.
2. Use the OpenAPI document for request and response schemas.
3. Set a unique idempotency key for each logical billable action.
4. Preserve the returned request ID.
5. Honor rate-limit and retry headers.
6. Review generated marketing claims, WhatsApp drafts, image text, and audio before publishing.

## Authoritative developer resources

- OpenAPI 3.1: https://www.lahjty.com/api/v1/openapi
- Live capabilities: https://www.lahjty.com/api/v1/capabilities
- English API docs: https://www.lahjty.com/en/api-docs
- Arabic API docs: https://www.lahjty.com/ar/api-docs
- API examples for agents: https://www.lahjty.com/partner-api.md
- Developer dashboard: https://www.lahjty.com/en/developers
- Pricing: https://www.lahjty.com/en/pricing
- Contact: https://www.lahjty.com/en/contact