Propone o mejora un texto. Consume créditos y no guarda nada.
POST
/ai-helper/suggest
const url = 'https://api.matiasimpulso.com/ai-helper/suggest';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"about":"example","mode":"idea","text":"example","maxWords":80,"context":{"businessDescription":"example","agentName":"example","agentRole":"example","tone":"example","language":"es"},"variables":["firstName","ticket_id"]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.matiasimpulso.com/ai-helper/suggest \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "about": "example", "mode": "idea", "text": "example", "maxWords": 80, "context": { "businessDescription": "example", "agentName": "example", "agentRole": "example", "tone": "example", "language": "es" }, "variables": [ "firstName", "ticket_id" ] }'Authorizations
Sección titulada « Authorizations »Request Bodyrequired
Sección titulada « Request Bodyrequired » Media type application/json
object
about
required
Qué es el campo y quién lo lee. Es dato para el modelo, no instrucción.
string
mode
required
string
text
Texto a mejorar (obligatorio con mode=improve) o idea de la que partir (mode=idea).
string
maxWords
number
context
object
businessDescription
string
agentName
string
agentRole
string
tone
string
language
string
Example
es variables
Variables que el campo sustituye al usarse (sin llaves). Únicos marcadores que puede escribir el modelo.
Array<string>
Example
[ "firstName", "ticket_id"]Responses
Sección titulada « Responses »{ suggestion, truncated }
Petición no válida o usuario sin empresa
Sin créditos o modelo fuera del plan
Requiere perfil de administrador
El modelo rechazó redactar el texto
Demasiadas peticiones seguidas
Asistente no disponible o sin respuesta
El modelo tardó demasiado