feat(genapi): update recommandations in troubleshooting

Author: fpagny

pages/generative-apis/troubleshooting/fixing-common-issues.mdx

@@ -53,13 +53,24 @@ Below are common issues that you may encounter when using Generative APIs, their
 
 ## Structured output (e.g., JSON) is not working correctly
 
-### Cause
+### Description
+- Structured output response contains invalid JSON
+- Structured output response is valid JSON but content is less relevant
+
+### Causes
 - Incorrect field naming in the request, such as using `"format"` instead of the correct `"response_format"` field.
 - Lack of a JSON schema, which can lead to ambiguity in the output structure.
+- Maximum tokens is lower than what the model response needs to be complete.
+- Temperature is not set or set too high.
+
 
 ### Solution
 - Ensure the proper field `"response_format"` is used in the query.
 - Provide a JSON schema in the request to guide the model's structured output.
+- Ensure the `max_tokens` value is higher than the response `completion_tokens` value. If this is not the case, the model answer may be stripped down before it can finish the proper JSON structure (and lack closing JSON brackets `}` for example). Note that if the `max_tokens` value is not set in the query, [default values apply for each models](/generative-apis/reference-content/supported-models/).
+- Ensure the `temperature` value is set with a lower range value for the model. If this is not the case, the model answer may output invalid JSON characters. Note that if the `temperature` value is not set in the query, [default values apply for each models](/generative-apis/reference-content/supported-models/). As examples:
+  - for `llama-3.3-70b-instruct`, `temperature` should be set lower than `0.6`
+  - for `mistral-nemo-instruct-2407	`, `temperature` should be set lower than `0.3`
 - Refer to the [documentation on structured outputs](/generative-apis/how-to/use-structured-outputs/) for examples and additional guidance.