Cómo usar la API de Venice

Cómo usar la API de Venice

La API de Venice brinda acceso a modelos de IA de vanguardia para la inferencia de texto e imágenes, con una estructura de costos única que utiliza las VCU apostando VVV o pagando directamente con USD

Venice.ai

La API de Venice le permite utilizar la infraestructura principal de Venice a través del formato API OpenAI estándar. La API proporciona acceso a modelos de IA de última generación para la inferencia de textos e imágenes, con una estructura de costes única que utiliza «VCU» apostando VVV o pagando directamente con USD. Puedes obtener más información sobre la API de Venice aquí.

Tabla de contenido

Cómo acceder a la API de Venice para realizar inferencias de IA privadas y sin censura

Los usuarios pueden acceder a la API de Venice de tres maneras diferentes:

  1. Cuenta Pro: los usuarios con una cuenta PRO tendrán acceso a la API de Venice dentro del «Nivel Explorer». Este nivel tiene límites de velocidad más bajos y está diseñado para interactuar fácilmente con la API.

  2. VCus: Con Venices lanzamiento del token VVV, los usuarios que apuestan fichas dentro del protocolo Venice obtienen acceso a una asignación diaria de inferencias de IA (así como a un rendimiento de participación continuo). Al apostar, los usuarios reciben VCU, que representan una parte de la capacidad informática total de Venice. Puedes apostar fichas VVV y consulta tu asignación de VCU aquí. Los usuarios con un saldo positivo de VCU tienen derecho a los límites de tarifas del «nivel de pago».

  3. USD: los usuarios también pueden optar por depositar USD en su cuenta para pagar la inferencia de la API de la misma manera que lo harían en otras plataformas, como OpenAI o Anthropic. Los usuarios con un saldo positivo en USD tienen derecho a unos límites tarifarios de «nivel de pago».

Estructura de costes de la API de Venice

La API utiliza precios estándar basados en tokens, denominados en USD y VCU.

Estos varían según el modelo seleccionado, y se puede encontrar aquí. Tenga en cuenta que actualmente existen límites de tarifa para el uso de la API, separados por «nivel de explorador» y «nivel de pago», que están siendo evaluado de forma continua.

Ponte en contacto con nosotros si estás interesado en incorporarte, pero los límites de tarifas representan un problema para ti.

Cómo generar una clave API de Venice

Una vez que lleguemos al nivel de API «Explorer» o «Paid», comenzaremos a generar nuestra clave de API.

  1. Dirígete al Panel de API de Venice

  2. Desplázate hacia abajo hasta las claves de API y haz clic en «Generar nueva clave de API»

  3. Introduce la información relevante, haz clic en «Generar» y, a continuación, guarda tu clave de API

Nota: Para obtener instrucciones más detalladas sobre la generación de claves de API, ve aquí.

Elegir un modelo con la API de Venice

Ahora que tenemos nuestra clave de API, vamos a elegir el modelo que queremos usar. Venice tiene una herramienta integrada que ayuda a facilitar las solicitudes sencillas directamente a través del sitio web en.

La URL base para los modelos de anuncios es:

https://api.venice.ai/api/v1/models

1. Busca la sección que muestra «GET /models» y haz clic en «Pruébalo»

2. Pega tu clave de API en la sección Autorización y, a continuación, elige si quieres consultar modelos de imagen o texto

3. Verás que el cuadro de la esquina superior derecha contiene el comando asociado que se puede usar para realizar la llamada a la API. Para este ejemplo estamos usando cURL, pero puedes usar Python, JavaScript, PHP, Go o Java desde esta herramienta

4. Introduzca la solicitud en una ventana del terminal o haga clic en «Enviar» directamente en la página web para ejecutar la solicitud

5. Verás la respuesta de 200 http con todos los modelos disponibles en Venice (la imagen superior es a través del sitio web, la imagen inferior muestra la terminal)

6. Elige el modelo de la lista que te gustaría usar y copia la «identificación». Esta identificación se utilizará para seleccionar tu modelo cuando crees mensajes de chat o imágenes

Creación de un mensaje de chat con la API de Venice

Para esta sección, enviaremos nuestro primer mensaje de chat a la modelo. Hay varias opciones y ajustes que se pueden utilizar en esta sección. Para los fines de esta guía, mostraremos el ejemplo más simple de un mensaje de texto simple

La URL base para el chat de texto es:

https://api.venice.ai/api/v1/chat/completions

1. Ir a: https://docs.venice.ai/api-reference/endpoint/chat/completions

2. Busca la sección «PUBLICAR /chat/terminaciones» y haz clic en «Pruébalo»

3. Introduzca la clave de API que identificó en la sección anterior

4. Introduzca la ID del modelo que identificó en la sección anterior

5. Ahora agregaremos los «mensajes», que proporcionan contexto al LLM. Las selecciones clave aquí son el «rol», que se define como «Usuario», «Asistente», «Herramienta» y «Sistema». El primer mensaje del sistema suele ser «Eres un asistente útil».

Para ello, seleccione «Mensaje del sistema - objeto» y establezca el «rol» en «sistema». Luego incluye el texto dentro de la sección «contenido»

6. Tras el mensaje del sistema, incluirá el primer mensaje de «usuario». Puede hacerlo haciendo clic en «Agregar un elemento» y, a continuación, configurando la opción en «Mensaje de usuario: objeto». Selecciona el «rol» y el «usuario» e incluye el mensaje de usuario que te gustaría usar en el apartado «contenido»

7. Al proporcionar el contexto del chat, incluirás las instrucciones del usuario y las respuestas de LLM. Para ello, haga clic en «Añadir un elemento» y, a continuación, defina la opción como «Mensaje del asistente: objeto». Defina el «rol» como «asistente» y, a continuación, introduzca la respuesta del LLM dentro del «contenido». No usaremos esto en nuestro ejemplo de solicitud.

8. Cuando hayas completado todas las entradas, verás el comando cURL asociado generado en la esquina superior derecha. Este es el comando generado con nuestra configuración

curl --request POST \
  --url https://api.venice.ai/api/v1/chat/completions \
  --header 'Authorization: Bearer <your api key> ' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "llama-3.3-70b",
  "messages": [
    {
      "role": "system",
      "content": "You are a helpful assistant."
    },
    {
      "role": "user",
      "content": "Tell me about AI."
    }
  ]
}'

9. Puedes elegir entre hacer clic en «Enviar» en la esquina superior derecha o introducirlo en una ventana de terminal. Una vez que el sistema ejecute el comando, recibirá una respuesta del http200 con lo siguiente:

{
  "id":"chatcmpl-3fbd0a5b76999f6e65ba7c0c858163ab",
  "object":"chat.completion",
  "created":1739638778,
  "model":"llama-3.3-70b",
  "choices":[
   {
     "index":0,
     "message":{
       "role":"assistant",
       "reasoning_content":null,
       "content":"AI, or Artificial Intelligence, refers to the development of computer systems that can perform tasks that would typically require human intelligence, such as learning, problem-solving, and decision-making. These systems use algorithms and data to make predictions, classify objects, and generate insights. AI has many applications, including image and speech recognition, natural language processing, and expert systems. It can be used in various industries, such as healthcare, finance, and transportation, to improve efficiency and accuracy. AI models can be trained on large datasets to learn patterns and relationships, and they can be fine-tuned to perform specific tasks. Some AI systems, like chatbots and virtual assistants, can interact with humans and provide helpful responses.",
       "tool_calls":[]
   },
   "logprobs":null,
   "finish_reason":"stop",
   "stop_reason":null
  }
],
"usage":{
  "prompt_tokens":483,
  "total_tokens":624,
  "completion_tokens":141,
  "prompt_tokens_details":null
},
  "prompt_logprobs":null
}

10. ¡Acabas de completar tu primer mensaje de texto con la API de Venice!

Creación de un mensaje de imagen con la API de Venice

Para esta sección, enviaremos nuestro primer mensaje de imagen a la modelo. Hay varias opciones y ajustes de imagen que se pueden usar en esta sección, así como opciones de generación o aumento de tamaño. Para este ejemplo, mostraremos el ejemplo más simple de una solicitud de imagen, sin seleccionar estilos.

La URL base para la generación de imágenes es:

https://api.venice.ai/api/v1/image/generate

La URL base para el escalado de imágenes es:

https://api.venice.ai/api/v1/image/upscale

1. Ir a https://docs.venice.ai/api-reference/endpoint/image/generate

2. Busca la sección «PUBLICAR /image/generate» y haz clic en «Pruébalo»

3. Introduzca la clave de API que identificó en la sección anterior

4. Introduzca la ID del modelo que identificó en la sección anterior

5. Ahora añadiremos la «línea de comandos» para que el LLM la utilice para generar la imagen.

6. Hay una variedad de otros ajustes que se pueden configurar en esta sección, mostramos el ejemplo más simple. Cuando hayas completado todas tus entradas, verás el comando cURL asociado generado en la esquina superior derecha. Este es el comando generado usando nuestra configuración

curl --request POST \
  --url https://api.venice.ai/api/v1/image/generate \
  --header 'Authorization: Bearer <your api key> ' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "fluently-xl",
  "prompt": "Generate an image that best represents AI"
}'

7. Puedes elegir entre hacer clic en «Enviar» en la esquina superior derecha o introducirlo en una ventana de terminal. Una vez que el sistema ejecute el comando, recibirá una respuesta del http200 con lo siguiente:

{
  "request": {
  "width":1024,
  "height":1024,
  "width":30,
  "hide_watermark":false,
  "return_binary":false,
  "seed":-65940141,
  "model":"fluently-xl",
  "prompt":"Generate an image that best represents AI"
},
"images":[ <base64 image data>

Nota importante: Si prefiere tener solo la imagen, en lugar de los datos de la imagen en base64, puede cambiar la configuración de «return_binary» a «true». Si cambias esta selección, solo recibirás la imagen y no la respuesta JSON completa.

8. ¡Acabas de completar tu primera solicitud de imagen con la API de Venice!

Empieza a crear con la API de Venice ahora

Hay un montón de ajustes en la API para la generación de texto e imágenes que te ayudarán a adaptar la respuesta exactamente a lo que necesitas.

Recomendamos a los usuarios avanzados que evalúen esta configuración y realicen modificaciones para optimizar los resultados. La información relativa a estos ajustes es disponible aquí.

Comuníquese con [email protected] o en el canal #api de nuestra discordia ¡con cualquier pregunta!

Volver a todas las publicaciones
Room