+ Začít tvořit

API napojení nástoje ELIDat

Pro získání API přístupu nás neváhejte kontaktovat

🔐 Autentizace

elidat.cz umožňuje snadno vytvářet profesionální videa pro prezentaci nemovitostí.

⚠️ Důležité:
Pro používání API je nutné se zaregistrovat a získat svůj unikátní API klíč. Tento klíč je vyžadován u všech požadavků a je navázán na váš kreditní účet.


Každý požadavek musí obsahovat API klíč:

Authorization: Bearer <váš_api_klíč>
 

🧑‍💻 Endpointy

1. Vytvoření video projektu

POST /project

Vytvoří nový projekt s detaily nemovitosti a konfigurací.


Při vytváření projektu musí být vždy vyplněny:

  1. Adresa pozemku / nemovitosti – pole location

  2. Alespoň jedna fotografie – v objektu media.images musí být minimálně 1 obrázek

  3. Kontaktní údaje – v objektu contact_info 

Bez těchto údajů nebude možné projekt vytvořit.


Tělo požadavku

{
"location": "Hlavní 123, Praha",
"media": {
"images": ["https://example.com/img1.jpg", "https://example.com/img2.jpg"],
"videos": ["https://example.com/clip1.mp4"],
"ai_visualization": true,
"image_to_video": true
},
"audio": {
"voice_over": "https://example.com/voice.mp3",
"music_track": "https://example.com/music.mp3"
},
"texts": {
"header": "Krásný rodinný dům",
"sub_header": "Praha – klidná lokalita",
"body": "Prostorný dům se 3 ložnicemi a moderním vybavením."
},
"points_of_interest": {
"schools": true,
"shops": true,
"bus_stops": false,
"playgrounds": true,
"sport_facilities": true,
"hospitals": true,
"doctors": true,
"restaurants": true
},
"contact_info": {
"agent_name": "Jan Novák",
"phone": "+420 777 123 456",
"email": "jan.novak@example.com"
}
}

 

Odpověď

{
"project_id": "prj_abc123",
"status": "created",
"message": "Projekt úspěšně vytvořen. Použijte /project/{id}/preview pro vygenerování náhledu."
}

2. Generování náhledového videa

POST /project/{id}/preview

Vytvoří náhled videa pro kontrolu.


Odpověď

{
"project_id": "prj_abc123",
"status": "processing",
"preview_url": "https://cdn.realestatevideo.ai/previews/prj_abc123.mp4"
}

3. Schválení a finální video

POST /project/{id}/finalize

Po schválení náhledu lze vytvořit finální video (vyžaduje kredity).


Tělo požadavku

{

"credits_to_use": 10
}
 

Odpověď

{
"project_id": "prj_abc123",
"status": "finalized",
"download_url": "https://cdn.realestatevideo.ai/videos/prj_abc123_full.mp4",
"credits_remaining": 90
}

4. Stav projektu

GET /project/{id}

Vrátí aktuální stav projektu.


Odpověď

{
"project_id": "prj_abc123",
"status": "preview_ready",
"preview_url": "https://video.elidat.cz/previews/prj_abc123.mp4"
}

5. Platby a kredity

  • GET /credits – Zjistí dostupné kredity

  • POST /credits/purchase – Nákup dalších kreditů


Příklad požadavku

 
{
"package": "premium_50"
}

Odpověď 

{
"credits_added": 50,
"credits_total": 140
}

Pracovní postup

  1. Registrace → získáte unikátní API klíč

  2. Vytvoření projektu → /project

  3. Generování náhledu → /project/{id}/preview

  4. Kontrola náhledu (zdarma)

  5. Finální video → /project/{id}/finalize (placeno kredity)

  6. Stažení hotového videa


⚠️ Chybové hlášky

API vrací chyby v JSON formátu:

{
"error": {
"code": 404,
"message": "Property not found"
}
}


Kódy:

  • 400 – Bad Request

  • 401 – Unauthorized

  • 403 – Forbidden

  • 404 – Not Found

  • 500 – Internal Server Error

Měníme svět realit

Facebook-f Youtube Linkedin
Důležité odkazy

Obchodní podmínky

Ochrana osobních údajů

Nápověda

Kontakt