Visual To Text

This API allows you to generate content based on image or video as an input.

Headers

The request should include the following header:

X-API-KEY: <Your API Key>

Embed Image or Video

To pass an image to this Generation API, you need to first pass an id of that image or video. To obtain an _id, you need to upload the visual content using our embedding endpoint.

Embeds

Image To Text Endpoint

https://api.axv.ai/api/generation/:format/:model/:content_id

Request Parameters

Parameter	Description
format	The format of the content to be generated. Can be either "Image" or "Video".
model	The model to be used for generating the content. Can be either "Description" or "Facebook Ad".
content_id	The ID of the image or video for which the content needs to be generated.

List of Available Models

Here is a table listing the models along with their respective inputs and descriptions:

Video Only Endpoints

Model	Purpose	Model Route
Clips	Extract clips from videos	clips
Idea Generation	Generate video ideas	idea_generation
Audio Description	Generate audio descriptions for videos	audio_description
Short Video Ideas	Generate short video ideas	short_video_ideas

Video and Image Endpoints

Name	:model	Description
Facebook Ad	facebook_ad	Generates text tailored for creating Facebook ads
Instagram Caption	instagram_caption	Generates captions for Instagram posts
LinkedIn Post	linkedin_post	Generates text for creating LinkedIn posts
Buyer Persona	buyer_persona	Generates a description for a buyer persona
Audio Descriptions	audio_description	Generates descriptions for audio content
Video Feedback	video_feedback	Generates feedback for videos
Video Ideas	video_ideas	Generates ideas for creating videos
Classify	classify	Classifies input text
Ecommerce SEO	commerce_seo_keywords	Generates SEO keywords for e-commerce websites
E-commerce Product Descriptions	commerce_product_descriptions	Generates descriptions for e-commerce products

Response

Upon a successful request, the API will respond with the following JSON data:

{
	"isSuccess": true,
	"listData": [
		{
			"_id": "648ff69025155f2c82377ce9",
			"file_url": "https://storage.googleapis.com/download/storage/v1/b/fussydata/o/1bb0045ddd59da076bdff18a0d6e98b8.jpg?generation=1687156368118329&alt=media",
			"media_type": "visual",
			"generations": [
				"This content is a visual representation of file holder envelopes and papers. The image showcases a file holder with several files neatly organized within it. The files are various sizes, colors and designs, indicating a diverse range of documents or materials that can be stored in these file holder envelopes. This image reflects the concept of organization, efficiency, and professionalism in managing paperwork and important documents. Whether used in offices, schools, or home offices, these file holder envelopes and papers provide a practical and convenient solution for keeping important materials secure and easily accessible."
			]
		}
	]
}

Response Properties

Property	Description
isSuccess	A boolean value indicating whether the request was successful (true) or not (false).
listData	An array containing the generated content data.
_id	The ID of the generated content.
file_url	The URL of the generated image or video file.
media_type	The type of the generated media. Either "visual" for an image or "video" for a video.
generations	An array of generated content descriptions or ad texts.

Example Usage

GET https://api.axv.ai/generation/Image/Description/648ff69025155f2c82377ce9

This request generates a description for the image with the ID "648ff69025155f2c82377ce9". The response will contain the generated content information as described above.